Modbus TCP中MBAP头length字段应填PDU长度（如0x03请求为0x0006），填错致连接重置；响应需按byte count/2解析寄存器，避免越界；libmodbus超时宜设2–5秒；多线程须为每线程独用modbus_t实例。
Modbus TCP 读保持寄存器时，mbap 头部长度字段填错会导致连接被重置
很多人用 libmodbus 或手写 socket 解析时，在构造 Modbus TCP 请求报文时，误把 length 字段（MBAP 头部第 4–5 字节）设为整个报文长度（包括 MBAP 头），实际它只应表示「协议数据单元 PDU 长度」，即从功能码开始往后字节数（不含 MBAP 头）。填大了，服务端会认为后续数据超长，直接 RST 连接；填小了则截断响应。
正确计算方式：
- 读保持寄存器（功能码
0x03）请求 PDU 固定为 6 字节：0x03+ 起始地址高/低 + 寄存器数量高/低 - 所以
length应为0x0006（网络字节序） - 完整报文前 6 字节 MBAP：事务ID（2）、协议ID（2）、
length（2）、单元ID（1）→ 共 7 字节
手写时建议用 htons(6) 赋值，别硬编码 0x0006 —— x86 和 ARM 对字节序处理一致，但显式转换更安全。
解析 0x03 响应报文时，PDU 中的字节数字段和寄存器数量不相等
Modbus 协议规定：响应 PDU 第 2 字节是「字节数」（byte count），表示后续数据总字节数；每个保持寄存器占 2 字节，所以真实寄存器数量 = byte count / 2。但很多初学者直接用请求里的寄存器数去截取数据，忽略服务端可能返回少于请求的数量（例如地址越界、权限不足）。
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
典型错误现象：解析出乱码或 std::out_of_range 异常。
- 务必先读取响应 PDU 第 2 字节（索引 offset=2，跳过功能码），得到
byte_count - 校验
byte_count % 2 == 0，否则报IllegalDataValue异常（功能码0x83） - 再按
byte_count / 2个寄存器解析，每个寄存器用uint16_t从高位字节开始组合（网络序 → 主机序）
示例：收到 PDU 0x03 0x04 0x01 0x02 0x03 0x04，byte_count = 0x04 → 2 个寄存器 → {0x0102, 0x0304}。
使用 libmodbus 时，modbus_set_response_timeout() 设太短会丢响应
工业现场 Modbus TCP 延迟波动大：PLC 负载高、交换机 QoS、长网线带来的几十 ms 延迟都常见。默认 timeout 是 1 秒，但在嵌入式设备或高负载 PLC 场景下，可能需设到 2–5 秒。设太短（如 100ms）会导致 modbus_receive() 直接超时返回 -1，但服务端其实已发回响应——只是你没等到。
- 不要依赖
modbus_get_response_timeout()查当前值，它返回的是 struct 内部副本，不反映实际 socket 层状态 - 设 timeout 后，务必检查返回值：
if (modbus_set_response_timeout(ctx, 3, 0) == -1)→ 打印modbus_strerror(errno) - 若需更高精度，可改用
poll()+ 自定义超时逻辑，绕过 libmodbus 的阻塞 recv
多线程调用 libmodbus 时，同一个 modbus_t* 实例不能并发访问
libmodbus 的上下文对象不是线程安全的：内部缓存了 socket fd、上次事务 ID、错误计数等共享状态。两个线程同时调用 modbus_read_registers()，可能造成事务 ID 冲突、响应错配、甚至 core dump。
- 每个线程必须持有独立的
modbus_t*（即各自modbus_new_tcp()+modbus_connect()） - 若需复用连接，应在上层加互斥锁（如
std::mutex），且锁粒度覆盖整个读写周期（connect → read → close），不能只锁单个函数调用 - 注意：频繁新建/关闭 TCP 连接在工业场景中不可取，优先选连接池或单线程事件循环（如结合
libev）
真正麻烦的不是锁本身，而是当多个线程轮询同一台 PLC 的不同寄存器地址时，容易误以为“共用一个 ctx 更省资源”——结果响应被交叉污染，数据对不上地址，调试时极难复现。
