QModbusDevice状态无法反映真实连接状态的技术问询

问题分析 #

Qt的QModbusTcpClient进入ConnectedState后，不会主动检测TCP连接是否已断开——因为TCP长连接本身没有内置心跳机制，除非有读写操作触发错误，或者底层套接字收到明确的断开通知，否则客户端会一直认为连接处于活跃状态。这就是关闭服务器WiFi后，客户端状态无法切换到UnconnectedState的核心原因。

可行解决方案 #

1. 启用TCP KeepAlive机制 #

通过配置底层QTcpSocket的KeepAlive选项，让TCP协议层自动检测死连接，当连接中断时触发状态变更：

#include <QDebug>
#include <QModbusTcpClient>
#include <QTcpSocket>

int main(int argc, char *argv[]) {
  QCoreApplication a(argc, argv);
  QModbusTcpClient client;

  // 监听状态变化并重连
  QObject::connect(&client, &QModbusDevice::stateChanged, &a,
                   [&client](auto const &state) {
                     qDebug() << "State changed" << state;
                     if (QModbusDevice::UnconnectedState == state)
                       client.connectDevice();
                   });

  // 监听底层套接字断开信号，手动触发状态切换
  QObject::connect(client.socket(), &QTcpSocket::disconnected, &client, [&client](){
      qDebug() << "Socket disconnected, updating state";
      client.disconnectDevice();
  });

  // 配置TCP KeepAlive参数
  if (auto socket = client.socket()) {
      socket->setSocketOption(QAbstractSocket::KeepAliveOption, true);
      // 部分系统需额外配置（如Linux），可根据场景调整
      // socket->setSocketOption(QAbstractSocket::TcpKeepAliveIntervalOption, 3000);
      // socket->setSocketOption(QAbstractSocket::TcpKeepAliveProbesOption, 3);
  }

  client.setConnectionParameter(QModbusDevice::NetworkPortParameter, 502);
  client.setConnectionParameter(QModbusDevice::NetworkAddressParameter,
                                "192.168.8.6");
  client.setTimeout(500);
  client.setNumberOfRetries(5);
  client.connectDevice();

  return a.exec();
}

2. 定期发送检测请求 #

主动发送无意义的Modbus请求（如读取0个寄存器），当请求失败且达到重试次数时，客户端会自动切换到UnconnectedState：

#include <QDebug>
#include <QModbusTcpClient>
#include <QTimer>

int main(int argc, char *argv[]) {
  QCoreApplication a(argc, argv);
  QModbusTcpClient client;
  QTimer keepAliveTimer;

  // 状态变化处理，控制检测定时器启停
  QObject::connect(&client, &QModbusDevice::stateChanged, &a,
                   [&client, &keepAliveTimer](auto const &state) {
                     qDebug() << "State changed" << state;
                     if (QModbusDevice::ConnectedState == state) {
                         keepAliveTimer.start(3000); // 每3秒发送一次检测请求
                     } else {
                         keepAliveTimer.stop();
                     }
                     if (QModbusDevice::UnconnectedState == state)
                       client.connectDevice();
                   });

  // 定期发送检测请求
  QObject::connect(&keepAliveTimer, &QTimer::timeout, &client, [&client](){
      if (client.state() != QModbusDevice::ConnectedState) return;
      // 发送读取0个保持寄存器的请求，仅用于检测连接
      auto request = client.sendReadRequest(QModbusDataUnit(QModbusDataUnit::HoldingRegisters, 0, 0), 1);
      if (!request) {
          qDebug() << "Keep-alive request failed:" << client.errorString();
          client.disconnectDevice();
      }
  });

  client.setConnectionParameter(QModbusDevice::NetworkPortParameter, 502);
  client.setConnectionParameter(QModbusDevice::NetworkAddressParameter,
                                "192.168.8.6");
  client.setTimeout(500);
  client.setNumberOfRetries(5);
  client.connectDevice();

  return a.exec();
}

注意事项 #

• TCP KeepAlive的行为依赖操作系统配置，不同系统默认参数有差异，需根据实际场景调整。
• 定期检测请求的间隔不宜过短，避免给服务器造成额外负载。
• 两种方案可结合使用，提升连接状态检测的可靠性。

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