QT编写的TCP Socket无法连接硬件但Hercules工具可正常连接求助

问题排查点 #

• 首先检查项目.pro配置文件是否添加了网络模块依赖，这是Qt网络开发最常见的遗漏点：

  QT += network
  

  缺该配置的情况下，网络相关接口不会正常工作，也不会抛出明显的编译错误。
• 关闭Qt套接字默认的系统代理：Qt默认会跟随系统代理配置，如果你开启了全局代理，访问内网地址时会被代理拦截，而Hercules工具一般不会走系统代理，所以会出现二者表现不一致的情况，在调用connectToHost前添加如下代码即可：

  socket->setProxy(QNetworkProxy::NoProxy);
  

• 检查本机防火墙规则：确认你编译生成的Qt应用拥有TCP出网权限，防火墙会默认放行常用工具的网络请求，新编译的自定义程序大概率会被拦截。
• 打印具体错误信息定位根因：不要只判断连接是否成功，在连接失败分支输出错误描述，能快速定位问题：

  else{
      qDebug() << "Connect failed, error:" << socket->errorString();
  }
  

  你也可以绑定errorOccurred信号异步捕获错误，能拿到更精准的错误类型，比如端口拒绝、地址不可达、超时等。
• 多网卡环境额外配置：如果你的运行设备同时存在多张网卡（比如同时连接WiFi和有线网），可以手动指定socket绑定的本地网卡地址：

  socket->bind(QHostAddress("你本机和板卡同网段的本地IP"));
  

• 补充注意点：waitForConnected是阻塞API，不要在UI主线程中设置过长的超时时间，否则会导致界面无响应，更推荐用connected信号异步监听连接结果。

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