如何解决pymodbus 3.12中‘Cleanup recv buffer before send’错误？

一、正确清除接收缓冲区的方法 #

pymodbus 3.x的RTU客户端底层依赖串口对象，你可以直接访问客户端的transport.serial属性来操作缓冲区：

• 清除输入缓冲区：mbClient.transport.serial.reset_input_buffer()
• 清除输出缓冲区（如需）：mbClient.transport.serial.reset_output_buffer()

在执行写入操作前先清理缓冲区即可：

# 清理接收缓冲区
mbClient.transport.serial.reset_input_buffer()
# 执行寄存器写入
mbClient.write_register(address=1, value=1, slave=1, no_response_expected=True)

二、禁用缓冲区检查（无需清理缓冲区） #

pymodbus 3.12默认开启严格模式（strict=True），会在发送前强制检查接收缓冲区是否为空。你可以在创建客户端时关闭这个检查：

from pymodbus.client import ModbusSerialClient

# 创建客户端时设置strict=False
mbClient = ModbusSerialClient(
    port='COM1',
    baudrate=9600,
    parity='N',
    stopbits=1,
    bytesize=8,
    strict=False
)

关闭严格模式后，即使接收缓冲区有残留数据，也不会触发该错误。

三、版本差异说明 #

pymodbus 3.10及以上版本新增了严格模式下的缓冲区检查逻辑，而3.0.2版本无此校验步骤，因此降级后代码可正常运行。

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