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 保证跨机器解析一致。

go
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))
}

预期输出

text
frame=0100020000000470696e67
header=7 payload=4 total=11

这 11 个字节可以直接拆成 01、0002、00000004 和 70696e67。只要双方对字段顺序、宽度和字节序有同一份约定,就不需要依赖一次 Read 恰好返回一整条消息。

让格式能够长期演进

Version 不应该被当成装饰字段。接收端遇到不支持的版本时应明确拒绝,而不是按当前格式“猜着解析”。Type 也应使用稳定编号,不要把 Go 枚举值或字符串序号直接暴露为协议约定,否则代码重排可能意外改变线上格式。

长度字段还需要同时约束编码端和解码端。编码端防止自身生成异常帧,解码端防止不可信输入诱导分配超大缓冲区。两端最好共享同一个最大值,例如本例的 1 MiB。

固定帧适合什么场景

这种格式适合 TCP 长连接、内部 RPC、自定义设备协议等需要高效顺序解析的场景。它的优点是边界明确、解析成本低、实现简单;缺点是字段一旦发布就需要兼容旧版本,新增字段也必须通过版本升级或扩展区设计。

真正稳定的消息格式,不只是“能编码成功”,而是能让任意一端仅凭固定帧头判断后续需要读取多少字节,并能在版本、类型或长度异常时立即停止解析。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

为消息定义固定帧格式

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通