package_length_offset 是包头内长度字段起始位置距离包头开头的字节数，例如 struct { uint16_t cmd; uint32_t len; } 中 len 从第2字节开始，故值为2。
package_length_offset 是什么位置的字节偏移
package_length_offset 指的是「包头内，长度字段起始位置距离包头开头的字节数」。它不关心包体、不关心总长，只回答一个问题：长度值从包头第几个字节开始存？
比如你定义包头是 struct { uint16_t cmd; uint32_t len; char data[0]; }，其中 cmd 占 2 字节，len 紧跟其后占 4 字节——那么 len 的起始位置就是第 2 字节，package_length_offset 就必须设为 2。
- 设成
0：表示长度字段就在包头最开头（常见于纯长度头，如 4 字节直接存 body 长度） - 设成
4：说明前 4 字节是别的字段（如 type、version），长度值从第 5 字节开始 - 若实际偏移填错，Swoole 会读错长度值，大概率触发
ERROR: package is too big或直接截断/粘包
package_length_offset 和 package_body_offset 容易混淆的点
这两个参数名字相似，但职责完全不同：package_length_offset 只管「长度字段在哪」，package_body_offset 管「包体从哪开始算」——后者直接影响 Swoole 截取消息体时的起始位置。
举个典型例子：包格式为 [2B type][4B len][4B seq][N B body]，共 10 字节包头，其中长度字段在第 2–5 字节（即 offset=2），而包体真正内容从第 10 字节后开始。此时：
package_length_offset => 2package_body_offset => 10- 如果误把
package_body_offset也填成2，Swoole 会从第 2 字节开始截 body，把原本属于包头的len和seq全当 body 内容发给onReceive，业务逻辑必然解析失败
package_length_type 如何影响 package_length_offset 的取值
package_length_type 决定了长度字段占几个字节、用什么字节序，它和 package_length_offset 是联动关系。填错类型会导致读出的长度值完全错误（比如本该是大端 N，却配成小端 V，数值可能差几百万倍）。
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
常见组合：
-
package_length_type => 'n'（16 位无符号短整型，网络序）→ 长度字段占 2 字节 →package_length_offset必须指向这 2 字节的首地址 -
package_length_type => 'N'（32 位无符号整型，网络序）→ 占 4 字节 → 若package_length_offset指向中间字节（如 +1），就会读到错位的 4 字节，结果不可预测 -
package_length_type => 'c'（有符号单字节）→ 占 1 字节 → 此时package_length_offset填任何整数都只读 1 字节，但若该字节实际是包头其他字段的一部分，仍会破坏语义
调试 package_length_offset 错误的最快方式
不要靠猜。直接在客户端发一个已知结构的测试包，用 tcpdump 或 Wireshark 抓包，看十六进制流里长度字段真实位置——然后对照你的配置反推是否匹配。
例如抓到包头前 12 字节是：00 00 00 01 00 00 00 0a 00 00 00 01，你预期第 9–12 字节（00 00 00 0a）是长度值（即 10），那就必须设 package_length_offset => 8（因为字节索引从 0 开始）。
容易被忽略的是：Swoole 所有 offset 都是**从包头起始算的绝对偏移，不是相对某个字段的偏移**。哪怕你协议文档写“length 字段位于 header 第三个字段”，也要手动算出它离 header 开头到底多少字节。
