黏包是TCP字节流不保留消息边界导致的多个消息粘连或单个消息拆分的现象；Go的net.Conn直接暴露TCP流，Read()返回字节数不确定，需自行通过固定长度头、bufio.Reader分隔符或gob/json流式解码等方案拆包。
什么是黏包，为什么 Go 的 net.Conn 会遇到它
TCP 是字节流协议，不保留应用层消息边界。Go 的 net.Conn 直接暴露底层 TCP 流，Read() 返回的字节数完全取决于内核缓冲区状态和网络状况——可能一次读到多个“包”，也可能一个“包”分多次读完。这不是 Go 的 bug，而是 TCP 本质；但新手常误以为 Write() 发一个结构体，对方 Read() 就能原样收一个。
常见错误现象：
- 客户端发了两条 JSON 消息，服务端
Read()一次性拿到拼在一起的字符串，json.Unmarshal()报invalid character - 用固定长度头（如 4 字节）解析消息体，但
Read()只读到 2 字节就返回，后续再读又混入下一条数据
关键点：黏包不是 Go 特有，但 Go 不像 Python 的 socket.recv() 那样默认带“按行/按长度”语义，你得自己负责拆包。
用 bufio.Reader + 自定义分隔符解决简单场景
适合日志推送、命令行协议等以换行符或特殊字符结尾的消息。比裸 Read() 稳定，且避免反复小内存分配。
立即学习“go语言免费学习笔记（深入）”；
使用场景：
- MQTT 的 CONNECT/CONNACK（纯文本控制报文）
- 内部微服务间基于行的轻量通信（如
GET /health\n）
实操建议：
-
bufio.NewReader(conn)包一层，再调用ReadString('\n')或ReadBytes('\n') - 注意：如果数据本身含
\n（比如 JSON 含换行），必须换分隔符或改方案 -
ReadString()会包含结尾符；ReadBytes()也是，记得bytes.TrimSuffix(buf, []byte{'\n'}) - 超时控制要设在
conn.SetReadDeadline()上，bufio.Reader不自动继承
用固定长度头 + io.ReadFull() 处理二进制协议
最常用、最可控的解法，适用于自定义 RPC、游戏协议、序列化数据（如 Protobuf、gob）。
参数差异：
- 头部通常 2 或 4 字节（uint16/uint32），表示后续 payload 长度
-
io.ReadFull()保证读满指定字节数，否则返回io.ErrUnexpectedEOF，比手动循环Read()更可靠
容易踩的坑：
- 头部字节序没统一（服务端用
binary.BigEndian，客户端用了LittleEndian，结果长度解析错成几 MB） - 忘记对头部做范围检查，恶意客户端发个
0xFFFFFFFF，直接make([]byte, 4GB)OOM -
io.ReadFull()第二个参数是切片，不是指针；传buf[:2]而不是&buf[0]
示例片段：
var header [4]byte
if _, err := io.ReadFull(conn, header[:]); err != nil {
return err
}
length := binary.BigEndian.Uint32(header[:])
if length > 1024*1024 { // 防爆内存
return errors.New("payload too large")
}
payload := make([]byte, length)
if _, err := io.ReadFull(conn, payload); err != nil {
return err
}用 gob 或 encoding/json 自带流式编码绕过黏包
不是“解决”黏包，而是让编码器自己处理边界。适合 Go 服务间通信，双方都可控。
性能与兼容性影响：
-
gob快、紧凑，但仅限 Go 生态；跨语言必须换 -
json通用，但每个消息都要加长度头（标准库不提供流式 JSON 解析），否则仍会黏——所以实际要用json.Decoder配合bufio.Reader，它内部会按 token 边界读取
实操建议：
- 用
json.NewDecoder(bufio.NewReader(conn))，然后反复.Decode(&v) - 每次
Decode()会自动跳过空白、定位到下一个完整 JSON 值（对象/数组/字符串等），天然抗黏包 - 但要求每条消息是合法独立 JSON，不能是
{"a":1}{"b":2}连写（这算两个 JSON，但中间无分隔符，Decode()会卡在第二个{处报错）
复杂点在于：所有方案都依赖「双方约定」。没有银弹——如果你对接的是 C++ 写的老协议，就得老老实实手撸长度头；如果只是两个 Go 服务，gob 加 io.ReadFull() 最省心。别指望 runtime 自动猜出你的消息边界。
