Go / 系统课时
为消息定义固定帧格式
为消息定义固定帧格式
TCP 只提供连续字节流,不会替应用划分消息边界。本节用一个固定 7 字节帧头定义版本、类型和载荷长度,再把载荷紧随其后,从而让发送端与接收端都能用同一规则判断“一帧从哪里开始、到哪里结束”。
学习目标
- 设计包含版本、类型、长度和载荷的稳定消息帧
- 明确长度字段的语义、字节序和最大载荷边界
- 用 Go 编码并验证一条完整消息
先把帧边界写成协议
固定帧头的价值不在于“字段固定”,而在于让接收端先读取一个确定大小的头,再根据头中的长度读取恰好一段载荷。本节采用网络协议常见的大端字节序,帧结构如下:
| 字段 | 大小 | 含义 |
|---|---|---|
| Version | 1 字节 | 协议版本,当前固定为 1 |
| Type | 2 字节 | 消息类型编号 |
| Length | 4 字节 | Payload 的字节数 |
| Payload | Length 字节 | 实际业务数据 |
因此固定帧头大小为 7 字节。Length 只表示载荷长度,不包含帧头本身;如果发送 "ping",其 UTF-8 字节数为 4,所以 Length 必须写成 4。

用 Go 编码固定帧
下面的程序把版本、类型和载荷编码成完整字节帧。示例把最大载荷限制为 1 MiB,并使用 binary.BigEndian 保证跨机器解析一致。
package main
import (
"encoding/binary"
"errors"
"fmt"
)
const (
headerSize = 7
maxPayloadSize = 1 << 20
)
type Message struct {
Version uint8
Type uint16
Payload []byte
}
func Encode(m Message) ([]byte, error) {
if len(m.Payload) > maxPayloadSize {
return nil, errors.New("payload too large")
}
frame := make([]byte, headerSize+len(m.Payload))
frame[0] = m.Version
binary.BigEndian.PutUint16(frame[1:3], m.Type)
binary.BigEndian.PutUint32(frame[3:7], uint32(len(m.Payload)))
copy(frame[headerSize:], m.Payload)
return frame, nil
}
func main() {
frame, err := Encode(Message{
Version: 1,
Type: 2,
Payload: []byte("ping"),
})
if err != nil {
panic(err)
}
fmt.Printf("frame=%x\n", frame)
fmt.Printf("header=%d payload=%d total=%d\n", headerSize, 4, len(frame))
}预期输出
frame=0100020000000470696e67
header=7 payload=4 total=11这 11 个字节可以直接拆成 01、0002、00000004 和 70696e67。只要双方对字段顺序、宽度和字节序有同一份约定,就不需要依赖一次 Read 恰好返回一整条消息。
让格式能够长期演进
Version 不应该被当成装饰字段。接收端遇到不支持的版本时应明确拒绝,而不是按当前格式“猜着解析”。Type 也应使用稳定编号,不要把 Go 枚举值或字符串序号直接暴露为协议约定,否则代码重排可能意外改变线上格式。
长度字段还需要同时约束编码端和解码端。编码端防止自身生成异常帧,解码端防止不可信输入诱导分配超大缓冲区。两端最好共享同一个最大值,例如本例的 1 MiB。
固定帧适合什么场景
这种格式适合 TCP 长连接、内部 RPC、自定义设备协议等需要高效顺序解析的场景。它的优点是边界明确、解析成本低、实现简单;缺点是字段一旦发布就需要兼容旧版本,新增字段也必须通过版本升级或扩展区设计。
真正稳定的消息格式,不只是“能编码成功”,而是能让任意一端仅凭固定帧头判断后续需要读取多少字节,并能在版本、类型或长度异常时立即停止解析。