使用pyModbusTCP调用write_single_coil()时出现_recv MBAP error求助

问题场景 #

运行pyModbusTCP代码向PLC写入线圈时，触发timeout error和_recv MBAP error，已确认PLC IP可ping通、更换过线缆，但问题未解决。

代码示例：

from pyModbusTCP.client import ModbusClient

c = ModbusClient('192.168.0.7', port=502, debug=True, auto_open=True, auto_close=False)

if c.is_open == False:
            print('not connected')
else:
            print('connected')

print(c.unit_id())

c.write_single_coil(0,True)

程序输出：

connected
1
Tx
[4A 62 00 00 00 06 01] 05 00 00 FF 00 
timeout error
_recv MBAP error

排查与解决步骤 #

• 确认PLC的Modbus TCP模式启用：多数PLC默认是RTU串口模式，需进入PLC配置界面，检查Modbus TCP服务是否开启，端口是否为502（部分厂商会自定义端口，需与代码配置一致）。
• 核对Unit ID（从站地址）：代码中unit_id()返回1，但PLC实际的Modbus从站地址可能不同。可在初始化客户端时显式指定正确的从站地址测试：

  c = ModbusClient('192.168.0.7', port=502, unit_id=PLC实际地址, debug=True, auto_open=True, auto_close=False)
  

• 验证线圈地址的有效性：确认write_single_coil(0, True)中的地址0属于PLC可写入的线圈范围，部分PLC线圈起始地址非0或部分地址为只读，需对照PLC地址映射表确认。
• 排查端口拦截问题：ping通仅说明网络连通，但防火墙（本地主机或PLC侧）可能拦截502端口的TCP通信。临时关闭本地防火墙测试，同时检查PLC是否有访问控制列表限制你的主机IP。
• 用第三方工具验证通信：使用Modbus Poll等工具连接PLC，尝试写入相同线圈地址。若工具也失败，问题出在PLC配置或网络；若工具成功，尝试升级pyModbusTCP版本：

  pip install --upgrade pyModbusTCP
  

• 检查PLC连接数限制：部分PLC有最大TCP连接数上限，若已有其他设备占用连接，断开后再测试代码。

内容的提问来源于stack exchange，提问作者Jun