Swoole自定义协议pack与json协议之区别

pack() 是 Swoole 协议类中将业务数据打包为字节流的方法，JSON 仅为载荷序列化格式；二者属不同层级，真正需区分的是帧结构设计与序列化方式。

pack() 二进制协议和 JSON 协议根本不是同一层的东西

pack() 是 Swoole 自定义协议类里一个方法名，负责把业务数据「打包」成原始字节流；而 JSON 是一种文本序列化格式。两者不构成对比关系——你完全可以在 pack() 里用 json_encode()，也可以用 msgpack_pack()，甚至直接拼二进制字段。真正要区分的是：协议帧结构设计（如带长头 vs EOF 分隔）和载荷序列化方式（JSON / MsgPack / Protobuf）。

为什么在 pack() 里硬编码 JSON 很容易出粘包问题

常见错误是这样写 pack()：

public function pack($data) {    return json_encode($data) . "n";}

这看似简单，但会直接破坏 Swoole 的自动拆包机制。原因如下：

• 如果没配 open_eof_split => true 和 package_eof => "n"，Swoole 根本不识别换行符，$data 在 onReceive 中仍是粘连的原始字节流
• 即使开了 EOF 检测，客户端只要发错一次（比如漏了 n 或中间混入 n），整条连接就会卡住或错位
• JSON 字符串本身可能含 n（比如多行日志字段），导致提前截断

用 pack() + 长度头才是生产环境主流做法

真正健壮的 pack() 应该先算长度、再拼内容、最后加校验或帧尾，例如：

public function pack($data) {    $body = json_encode($data, JSON_UNESCAPED_UNICODE);    $len = strlen($body);    return pack('N', $len) . $body . "x00";}

对应地，parse() 必须用 unpack('N', $buffer) 读前 4 字节，并严格判断缓冲区是否满足 $len + 1。这种结构不依赖内容特征，抗干扰强，且能被 Swoole 的 open_length_check 直接接管。

关键点：

• package_length_type => 'N' 必须和 pack('N', $len) 一致，否则长度乱码
• JSON 只负责 payload 序列化，边界控制交给长度字段，二者职责分离
• 如果追求更小体积和更快解析，把 json_encode() 换成 msgpack_pack() 即可，协议框架完全不用动

JSON 协议在 HTTP 场景下天然成立，但在纯 TCP 里必须自己补协议层

浏览器发 POST /api 带 JSON，服务端用 SwooleHttpServer 接收，那是 HTTP 协议已定义好消息边界（Content-Length 或 chunked）。但裸 TCP 没有这些，你传 JSON 字符串过去，Swoole 默认就当普通字节流处理——它不会主动找 { 或 } 来切包。

所以所谓“JSON 协议”，实际是“JSON 载荷 + 自定义边界规则”的组合。漏掉边界规则，只谈 JSON，等于没解决 TCP 粘包这个根本问题。

最容易被忽略的点：调试时用 telnet 手动发 JSON，几乎必然失败，因为人很难精准控制换行、长度、字节序；真要验证，得用 PHP 写客户端，用 pack() 发包，再抓包看 Wireshark 里是不是 00 00 00 xx 开头。