Go / 系统课时
为什么一次 Read 不是一条消息
为什么一次 Read 不是一条消息
TCP 只提供可靠、有序的字节流,不记录应用层“消息”的起止位置。一次 Write 的数据可能被多次 Read 取走,多条业务消息也可能在一次 Read 中同时出现;本节用可重复实验观察边界错位,并建立正确的拆包思路。
学习目标
- 解释为什么
Read返回的字节数不能代表一条完整消息 - 区分半包、粘包与 TCP 字节流本身的正常行为
- 知道应用协议必须自行定义并解析消息边界
Read 只返回当前可用字节
net.Conn.Read(p) 的语义是:把当前能读到的字节复制进 p,返回实际字节数 n。它承诺的是字节顺序,不承诺“发送端一次 Write 对应接收端一次 Read”。返回多少字节会受接收缓冲区大小、发送节奏、内核调度和网络传输等因素影响。
因此下面两种假设都不成立:
Read返回较少字节,不代表发送端只发了这么多。Read一次拿到很多字节,也不代表这些字节属于同一条业务消息。

半包和粘包从哪里来
“半包”通常指一次 Read 只拿到某条业务消息的一部分;“粘包”通常指一次 Read 同时拿到多条消息,或拿到一条完整消息再加下一条的一部分。它们不是 TCP 传输错误,而是应用层把连续字节流误当成消息队列后看到的现象。
例如应用约定 | 是消息结束符,逻辑上发送 cat| 和 dog| 两条消息。接收端若每次只准备 5 字节缓冲区,就完全可能先得到 cat|d,再得到 og|。此时第一轮既包含第一条完整消息,又包含第二条的开头。
用最小实验观察边界错位
为了让结果不受真实网络调度影响,下面使用 net.Pipe 构造一个同步字节流。发送端一次写入两条逻辑消息,接收端故意只用 5 字节缓冲区读取。
package main
import (
"fmt"
"io"
"net"
)
func main() {
reader, writer := net.Pipe()
defer reader.Close()
go func() {
defer writer.Close()
if _, err := writer.Write([]byte("cat|dog|")); err != nil {
panic(err)
}
}()
buf := make([]byte, 5)
for {
n, err := reader.Read(buf)
if n > 0 {
fmt.Printf("read %d bytes: %q\n", n, buf[:n])
}
if err != nil {
if err != io.EOF {
panic(err)
}
break
}
}
}预期输出
read 5 bytes: "cat|d"
read 3 bytes: "og|"这个结果说明,Read 的返回边界只与字节流读取过程有关。真实 TCP 连接同样不能把 Read 次数当作消息数量;即使某次测试“刚好一发一收”,也只是偶然现象。
正确做法是给字节流加帧
接收端必须依据应用协议重新找出消息边界,常见方法有固定长度、分隔符、长度前缀和更完整的头部结构。选择哪种方法取决于负载格式与协议需求,但核心原则相同:先把 Read 得到的字节追加到接收缓冲区,再按协议规则提取完整消息,剩余字节继续保留给下一轮。