Qt4迁移Qt5后遇socket notifiers跨线程禁用报错问题求助

问题根源 #

Qt5对QTcpSocket的线程安全约束远严于Qt4：所有涉及QTcpSocket的操作（包括启用/禁用socket通知器、读写数据、调用close()/abort()等）必须在该socket所属的线程中执行。Qt4时期的宽松检查允许跨线程操作不触发报错，但Qt5直接抛出此异常。

修复方案 #

• 严格遵循线程亲和性规则
  确认QTcpSocket的创建线程，所有操作必须在该线程内执行。若socket通过moveToThread()转移到子线程，所有操作需通过信号槽触发，或在子线程的事件循环中执行。

• 用信号槽替代跨线程直接调用
  例如关闭socket时，不要在子线程直接调用socket->close()，而是通过信号触发socket所属线程的槽函数执行操作：

  // Socket所属线程的类
  class SocketHandler : public QObject
  {
      Q_OBJECT
  public slots:
      void handleCloseSocket() {
          m_tcpSocket->close();
      }
  private:
      QTcpSocket* m_tcpSocket;
  };
  
  // 子线程中
  emit requestCloseSocket(); // 连接至SocketHandler的handleCloseSocket槽
  

• 禁止在非所属线程修改socket状态
  不要在子线程中调用setSocketDescriptor()、pause()、resume()这类会修改socket内部通知器状态的方法，所有状态变更交由socket所属线程处理。

• 添加线程检查快速定位问题
  可在操作socket前添加线程校验，快速定位违规代码：

  if (m_tcpSocket->thread() != QThread::currentThread()) {
      qWarning() << "Socket操作调用自错误线程";
      return;
  }
  

额外提示 #

• 使用QTcpServer时，Qt5推荐用addPendingConnection()替代手动移动socket线程，确保socket线程亲和性正确。
• 注意socket信号槽的连接类型，避免使用Qt::DirectConnection导致槽函数在非socket所属线程执行。

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