Swoole如何配置TCP底层拆包规则

Swoole 默认是不会帮你拆包的——这不是缺陷，而是 TCP 协议本身的特性决定的：字节流就像一条没有标记的河流，Swoole 没法猜出你的业务数据在哪里断开。你必须明确告诉它消息的边界在哪，否则 `onReceive` 收到的就是赤裸裸的原始 TCP 流，半条、两条拼在一起、带乱码的截断数据……统统都可能出现。

**关键配置项只有两个：`open_length_check`（按长度拆包）和 `open_eof_check`（按结束符拆包）。不配，就不拆。** 很多新手踩的坑，其实都是因为这个基础认知没到位。

为什么默认不拆包？

TCP 是字节流协议，Swoole 不可能知道你用的业务协议长什么样——是 JSON？是 XML？还是自定义二进制结构？它都不懂。所有拆包逻辑必须由你亲手告诉它：长度字段在哪里、占几个字节、包体从哪里开始。常见的错误现象——比如 `onReceive` 里收到半条消息、两条消息粘在一起、或者数据被截断带乱码——**这不是 Swoole 的 bug，是你没配拆包规则**。 列举几个典型翻车现场： - 没开 `open_length_check` 也没设 `package_eof` → 完全无拆包，纯裸流，爱咋咋地 - 开了 `open_eof_check` 但数据里恰好包含了 `package_eof` 对应的字符 → 错误切分，后续消息全乱 - 开了 `open_length_check` 但 `package_length_offset` 填错 → 把无关字节当成长度，直接截出垃圾数据

用 open_length_check 配固定包头协议（推荐）

生产环境最稳妥的方式，尤其适合二进制或包含任意字节的数据。核心思路是告诉 Swoole：长度字段在包头的哪个位置、占几个字节、包体从哪里开始。 假设你的协议是「前 4 字节为包体长度（大端 uint32），后面紧跟着真实数据」，配置如下： ```php $server->set([ 'open_length_check' => true, 'package_length_type' => 'N', // 4 字节无符号大端整数 'package_length_offset' => 0, // 长度值从第 0 字节开始 'package_body_offset' => 4, // 包体从第 4 字节开始 'package_max_length' => 81920, // 防止恶意超长包吃光内存 ]); ``` 几个容易踩的细节： - `package_length_type` 必须和 `pack()` 时用的一致。比如客户端用 `pack('n', $len)`（2 字节短整型），这里就得填 `'n'` - `package_body_offset` 不等于包头长度。如果包头共 16 字节，长度字段在第 12～15 字节，那么 `package_length_offset` 填 `12`，`package_body_offset` 填 `16` - `package_max_length` 是硬限制，超过这个值的包会被直接丢弃，不会触发 `onReceive`

用 open_eof_check 配文本类简单协议

只适用于纯文本、且你能确保业务数据中绝不会出现 `package_eof` 的场景——比如日志推送、命令行交互。配置示例（以换行符为界）： ```php $server->set([ 'open_eof_check' => true, 'package_eof' => "\n", 'open_eof_split' => true, // 让 Swoole 自动剥离 EOF 并分发完整消息 ]); ``` 几个关键约束： - 客户端每次 `send()` 必须带上 `\n`，漏了就会卡住，不触发 `onReceive` - 如果关掉 `open_eof_split`，`onReceive` 收到的数据仍然含 `\n`，你需要自己 `explode("\n", $data)` 处理，还要处理跨包换行（比如 `"hello\nworld"` 被拆成 `"hello\n"` 和 `"world"`） - HTTP、JSON、XML 等含换行的内容，**绝对不要用此方式**，否则数据里出现的换行会直接破坏协议

UDP 和 WebSocket 不走同一套机制

TCP 的 `open_length_check` / `open_eof_check` 对 UDP **无效**。UDP 是报文边界天然存在的协议，每个 `onPacket` 收到的就是一个独立 UDP 包——但你要自己校验完整性（比如加 CRC、实现重传逻辑）。 WebSocket 更特殊：`onMessage` 收到的已经是解帧后的完整文本或二进制帧，Swoole 内部已经按 WebSocket 协议完成了分帧与重组。**不能也不该再配 `open_length_check`**，强行配了会冲突甚至崩溃。 容易被忽略的一点：不同传输层（TCP/UDP/WebSocket）的事件回调入口、缓冲区行为、错误恢复策略完全不同。别想当然地把 TCP 的配置复制粘贴到 UDP Server 上试。