
当使用 net.Conn 传输含换行符的二进制数据(如 RSA 公钥)时,基于 \n 的分隔读取会提前截断。推荐采用长度前缀(length-prefixed)协议:先写入 4 字节大端整数表示后续数据长度,再读取指定字节数,确保消息完整性。
当使用 `net.conn` 传输含换行符的二进制数据(如 rsa 公钥)时,基于 `\n` 的分隔读取会提前截断。推荐采用长度前缀(length-prefixed)协议:先写入 4 字节大端整数表示后续数据长度,再读取指定字节数,确保消息完整性。
在构建安全通信(如 TLS 握手前的密钥交换)或自定义二进制协议时,依赖特定分隔符(如 \n)读取消息极易失败——因为加密数据(如 PEM 编码的公钥、ASN.1 序列化结果)天然可能包含任意字节,包括换行符。此时,bufio.NewReader(conn).ReadString('\n') 不再适用。
推荐方案:长度前缀协议(Length-Prefixed Protocol)
该方法将消息结构化为「头部 + 载荷」:头部固定 4 字节,以大端序(Big-Endian)编码载荷长度;接收方先读取头部,再按长度精确读取全部载荷。它简单、高效、无歧义,且完全兼容任意二进制内容。
✅ 发送端示例(写入完整消息):
import (
"encoding/binary"
"io"
"net"
)
func writeMessage(conn net.Conn, data []byte) error {
// 构造 4 字节长度前缀
prefix := make([]byte, 4)
binary.BigEndian.PutUint32(prefix, uint32(len(data)))
// 原子写入:先写前缀,再写数据(需检查每步错误)
if _, err := conn.Write(prefix); err != nil {
return err
}
if _, err := conn.Write(data); err != nil {
return err
}
return nil
}✅ 接收端示例(读取完整消息):
炫酷的jQuery二进制数字时钟,它的时分秒都是用二进制来表示,绿色表示该位值是1,灰色则表示0,原理是将时钟的时分秒分别实时转换成二进制,然后随着本地时间的更新而实时刷新
import (
"encoding/binary"
"io"
"net"
)
func readMessage(conn net.Conn) ([]byte, error) {
// 严格读取 4 字节前缀
prefix := make([]byte, 4)
if _, err := io.ReadFull(conn, prefix); err != nil {
return nil, err
}
// 解析长度(注意:uint32 最大 4GB,生产环境建议校验合理性)
length := binary.BigEndian.Uint32(prefix)
if length > 10*1024*1024 { // 示例:限制单条消息 ≤10MB
return nil, io.ErrUnexpectedEOF
}
// 按解析出的长度读取完整载荷
message := make([]byte, int(length))
if _, err := io.ReadFull(conn, message); err != nil {
return nil, err
}
return message, nil
}⚠️ 关键注意事项:
- 使用
io.ReadFull(而非conn.Read)确保读取指定字节数,避免因 TCP 分包导致部分读取; - 长度字段需做边界校验(如最大消息大小),防止恶意构造超长长度引发内存耗尽;
- 若需更高可靠性或复杂交互,可考虑标准协议:
textproto(适合文本命令)、JSON 封装(可读性强)、或直接复用 HTTP/gRPC; - 加密场景下,长度前缀本身不加密,但其后的
data可全程 AES/GCM 加密——前缀仅用于传输层定界,不影响应用层安全性。
此方案已广泛应用于 Go 生态中的自定义 RPC(如 gob 编码传输)、P2P 协议及安全信道初始化阶段,是平衡简洁性与鲁棒性的最佳实践。

















