使用Qt通过WebSocket从部署的Node.js服务器获取数据失败

背景 #

我开发了一个JavaScript服务器，客户端连接时会主动发送数据，已部署在Glitch和Render两个免费托管平台，Web客户端可正常访问：

• Glitch实例
• Render实例
  （注：Glitch服务器唤醒需15-20秒，Render需50秒）

Qt客户端代码 #

Widget::Widget(QWidget *parent)
    : QWidget(parent)
{
    connect(&m_webSocket, &QWebSocket::connected, this, &Widget::onConnected);
    connect(&m_webSocket, &QWebSocket::textMessageReceived,
            this, &Widget::onMessageReceived);
    connect(&m_webSocket, &QWebSocket::errorOccurred,
            this, &Widget::errorOccurred);

    // QUrl url("wss://send-gravity-box2d-wasm-js.onrender.com");
    QUrl url("wss://merciful-regal-soursop.glitch.me");
    m_webSocket.open(url);
}

Widget::~Widget() {}

void Widget::onConnected()
{
    qDebug() << "connected";
}

void Widget::onMessageReceived(const QString &message)
{
    qDebug() << message;
}

void Widget::errorOccurred(QAbstractSocket::SocketError error)
{
    qDebug() << error;
}

故障现象 #

• 连接Render服务器时，调试输出：

  connected
  QAbstractSocket::RemoteHostClosedError
  QAbstractSocket::RemoteHostClosedError
  

• 连接Glitch服务器时，调试输出：QAbstractSocket::ConnectionRefusedError

解决步骤 #

1. 匹配WebSocket路径 #

多数JS服务器会绑定特定的WebSocket路由（如/ws），Qt客户端直接连接根域名会导致服务器无法识别请求。修改连接URL添加对应路径：

// Glitch实例
QUrl url("wss://merciful-regal-soursop.glitch.me/ws");
// Render实例
QUrl url("wss://send-gravity-box2d-wasm-js.onrender.com/ws");

2. 处理Glitch连接拒绝问题 #

• 确保服务器完成唤醒：等待15-20秒后再发起连接，避免在服务器休眠状态下请求。
• 检查Glitch项目设置：确认已开启WebSocket支持，无防火墙或路由规则限制非Web客户端连接。

3. 解决Render远程关闭问题 #

• 开启WebSocket调试日志，查看握手细节：

  qputenv("QT_WEBSOCKET_DEBUG", "1");
  

• 若服务器有Origin验证，添加Origin请求头：

  QNetworkRequest request(url);
  request.setRawHeader("Origin", "https://your-allowed-origin.com");
  m_webSocket.open(request);
  

4. 验证SSL兼容性 #

Qt的QWebSocket使用wss时依赖正确的SSL配置：

• 确保客户端系统安装了必要的根证书。
• 调试阶段可临时关闭证书验证（生产环境请勿使用）：

  QSslConfiguration sslConfig = QSslConfiguration::defaultConfiguration();
  sslConfig.setPeerVerifyMode(QSslSocket::VerifyNone);
  m_webSocket.setSslConfiguration(sslConfig);
  

5. 确认协议版本兼容 #

Qt的QWebSocket默认支持RFC 6455标准协议，检查服务器端是否使用了旧版本WebSocket协议，若有需调整服务器配置或在Qt中指定兼容协议版本。

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