Pymodbus库通信延迟问题咨询：重复运行脚本的异常排查及项目场景预判

问题背景 #

我有一段使用pymodbus控制电机的示例代码，功能是更新当前电机的频率设置并发送前进指令，同时在操作中设置了特定的等待时间。代码如下：

from pymodbus.client import ModbusSerialClient
import time

PORT = "/dev/ttyAMA2"
BAUDRATE = 19200
PARITY = 'N'
STOPBITS = 1
SLAVE_ID = 1

REG_OP_CMD = 8
REG_FREQ_RAM = 13
REG_RESET = 1

def connect():
    client = ModbusSerialClient(
        port=PORT,
        baudrate=BAUDRATE,
        parity=PARITY,
        stopbits=STOPBITS,
        timeout=1
    )
    if client.connect():
        print("Connection successful.")
        result = client.read_holding_registers(address=8, count=1, slave=1)
        print("Result: ", result)
        return client
    else:
        print("Connection failed!")
        return None

def forward(client):
    return client.write_register(REG_OP_CMD, 2, slave=SLAVE_ID)

def stop_motor(client):
    return client.write_register(REG_OP_CMD, 1, slave=SLAVE_ID)

def set_freq(client, hz):
    raw = int(hz * 100)
    return client.write_register(REG_FREQ_RAM, raw, slave=SLAVE_ID)

def main():
    client = connect()
    if not client:
        return

    try:
        print("Frequency set to 20 Hz")
        set_freq(client, 20)
        time.sleep(2)

        print("Moving Forward...")
        forward(client)
        time.sleep(3)

        print("3 seconds passed. Motor stopped.")
        stop_motor(client)
        time.sleep(2)

        print("TEST COMPLETED SUCCESSFULLY...")

    finally:
        client.close()
        print("Port closed.")

if __name__ == "__main__":
    main()

当我在系统上连续运行这段代码一段时间后，电机的停止命令会出现延迟（这个情况不稳定，比如连续5次运行都正常，第6次就出现延迟；也可能10次正常后第11次出问题）。我有两个疑问：

1. 这种命令在一段时间后失效的问题，是不是因为脚本被连续重复运行导致的？如果是，我该怎么解决？
2. 如果在一个大型项目中，只建立一次连接，然后反复让电机执行“前进、等待3秒”的操作，我还会遇到这个问题吗？

版本信息

• pymodbus: 3.8.6

问题解答 #

针对问题1：连续重复运行脚本是否导致命令延迟？如何解决？ #

大概率是频繁启停脚本带来的串口资源未彻底释放，或者电机控制器（Modbus从站）处理连接请求过载导致的。给你几个具体的排查和解决方向：

• 检查串口资源释放情况：虽然你的代码在finally块里调用了client.close()，但串口设备的释放可能有微小延迟。可以在脚本结束前加个time.sleep(1)，或者在Linux下用lsof /dev/ttyAMA2命令查看有没有残留进程占用串口，如果有，手动杀掉这些进程再测试。
• 增加命令执行的有效性检查：当前代码只发送命令但没验证是否成功。比如发送停止命令后，检查返回值：

  stop_result = stop_motor(client)
  if stop_result.isError():
      print(f"停止命令发送失败: {stop_result}")
      # 可以尝试重发一次命令
      stop_result = stop_motor(client)
  

  这样能及时发现命令发送失败的情况，而不是等到延迟才察觉。
• 每次运行前重置电机控制器状态：你的代码里定义了REG_RESET但没用到，可以在连接成功后先发送复位命令，确保电机回到初始状态，避免之前的运行残留影响：

  def reset(client):
      return client.write_register(REG_RESET, 1, slave=SLAVE_ID)
  # 在connect函数的return前调用：
  reset(client)
  

• 避免过于频繁地启停脚本：给两次脚本运行之间加个3-5秒的间隔，让串口和电机控制器都有足够时间清理资源。

针对问题2：单次连接重复执行操作的场景是否会出现该问题？ #

这种场景下出现延迟的概率会大幅降低，因为你避免了频繁创建/销毁连接带来的资源泄漏和从站连接堆积问题。不过还是要注意几个细节来确保稳定：

• 保持连接活性：长时间空闲的串口连接可能会因为超时或硬件原因断开，可以定期发送一个心跳请求（比如每隔30秒读一次某个状态寄存器），确保连接始终有效。
• 添加异常处理与重连机制：如果连接意外断开，要能自动检测并重新建立连接，避免后续命令全部失效。
• 控制命令执行的节奏：不要在短时间内连续发送大量命令，给电机控制器留足够的处理时间（比如每次命令后加个0.1秒的小延迟，不需要像测试脚本里那么长，但也不能没有）。
• 同样要验证命令执行结果：和问题1的建议一样，每次发送命令后检查返回值，确保命令被从站正确接收和处理。

备注：内容来源于stack exchange，提问作者furkan