pyModbusTCP连接设备502端口正常 读保持寄存器超时排查

首先拆解你抓到的请求报文：
[59 50 00 00 00 06 01] 03 0F FF 00 20
各字段含义如下：

• 事务标识：0x5950（随机生成，符合协议规范）
• 协议标识：0x0000（标准ModbusTCP协议标识，正常）
• 后续长度字段：0x0006（长度计算正确，无报文格式错误）
• 单元标识（Slave ID/Unit ID）：0x01
• 功能码：0x03（读保持寄存器，和设备手册标注的支持功能匹配）
• 寄存器起始地址：0x0FFF（十进制4095）
• 读取寄存器数量：0x0020（十进制32）

端口能正常建立TCP连接但请求超时，90%以上是以下几个原因，按优先级排查：

• 地址偏移不匹配：这是ModbusTCP调试最常见的坑。绝大多数设备手册给出的寄存器地址是PLC风格的编号，保持寄存器统一以4开头、从40001开始计数，和Modbus协议实际传输的0基偏移地址存在固定偏移：手册里的40001对应协议传输地址0，40002对应地址1，以此类推。如果你手册里标注的4096是4xxxx段的PLC编号，实际要传入的偏移地址是4096 - 40001 = 95，而非直接传入4096。另外你当前传入参数4096时，实际发出的报文里起始地址是4095，本身也存在1位的地址偏差。你当前请求的地址段属于设备未定义的非法地址，部分工业设备不会返回标准Modbus异常码，会直接丢弃报文触发超时。
• 单元标识配置错误：你当前代码默认使用Unit ID=1，对于原生以太网接口的Modbus设备，很多仅响应Unit ID为0或255的请求，对其他ID的报文直接丢弃；如果是串口转ModbusTCP网关，这个ID需要和下游串口从站的地址匹配。你可以在初始化客户端时显式指定Unit ID重试，示例代码：

client = ModbusClient(host="device_IP", port=502, auto_open=True, debug=True, unit_id=255)

• 请求参数超限：部分设备对单次读取的寄存器数量有限制（比如最多一次读16个），你第一次读32个触发限制后，设备可能直接断链或者丢包，可以先尝试读1个寄存器验证连通性，再逐步增加数量。
• 访问控制拦截：不少工业设备默认开启IP白名单，仅允许配置过的IP地址访问寄存器，未授权IP的请求会被直接丢弃；也需要排查客户端和设备之间的防火墙、交换机ACL是否拦截了回程流量。

如果排查后设备返回报文，可直接根据Modbus异常码定位问题：功能码最高位置1即为异常响应，后续跟1字节异常码：01代表功能码不支持，02代表非法地址，03代表请求数量超限，04代表设备故障。

不用手写脚本，用现成工具可以大幅降低调试成本：

• 图形化工具可直接用Modbus Poll，配置好IP、端口、Unit ID、寄存器地址后一键发起请求，工具会自动解析返回值、异常码，不用手动处理报文格式。
• 命令行环境可使用mbpoll工具，全平台支持，安装后一行命令即可完成测试，比如读取Unit ID为255的设备、从1号寄存器（对应协议偏移0）开始的10个保持寄存器：

mbpoll -m tcp -a 255 -r 1 -c 10 device_IP

注意mbpoll默认使用1基寄存器编号，和多数设备手册的PLC编号规则对齐，不用手动算偏移。

• 最通用的排查手段是抓包：用Wireshark抓取客户端网卡和设备502端口的交互流量，软件自带ModbusTCP协议解析器，能直接看到请求是否正常发送、设备是否回包、回包内容是什么，能快速定位是链路问题、参数问题还是设备问题。

内容的提问来源于stack exchange，提问作者Marco Montevechi Filho