Qt QWebSocketServer配置：实现wss接受HTTPS环境下的客户端连接

针对你遇到的远程主机关闭连接的问题，按以下步骤排查和修复：

1. 确保服务端启动监听端口 #

你的服务端构造函数仅初始化了SSL配置，但没有调用listen()方法启动服务器，这是核心问题之一。在构造函数末尾添加监听逻辑，并验证启动结果：

// 在构造函数最后添加
if (!m_pWebSocketServer->listen(QHostAddress::Any, m_port)) {
    qDebug() << "服务端监听失败：" << m_pWebSocketServer->errorString();
} else {
    qDebug() << "服务端已启动，监听地址：wss://0.0.0.0:" << m_port;
}

2. 修复SSL证书域名不匹配问题 #

你使用的是localhost.cert证书，但客户端连接的是mydomain.org，证书的通用名称（CN）或主题备用名称（SAN）必须与实际连接的域名完全一致，否则浏览器会因证书验证失败主动关闭连接：

• 重新生成适配mydomain.org的SSL证书，确保CN字段为mydomain.org，或SAN字段包含该域名；
• 若为测试环境，可在客户端浏览器中手动导入根证书，将其设为可信；生产环境需使用CA签发的正规证书。

3. 验证证书与密钥的有效性 #

在加载证书和密钥后添加有效性检查，避免因文件加载失败导致SSL配置无效：

// 加载证书和密钥后添加
if (certificate.isNull()) {
    qDebug() << "证书加载失败，请检查文件路径或格式";
}
if (sslKey.isNull()) {
    qDebug() << "私钥加载失败，请检查文件路径或格式";
}

4. 开放网络与系统端口 #

• Windows防火墙：在防火墙规则中添加入站规则，允许服务端程序通过50000端口接收连接；
• 网络端口转发：若服务端位于内网，需在路由器中配置端口转发，将公网50000端口映射到服务端机器的内网IP和端口。

5. 优化SSL错误处理逻辑 #

服务端直接调用pSocket->ignoreSslErrors()过于草率，建议通过sslErrors信号捕获具体错误，便于排查问题（仅测试环境可临时忽略，生产环境需严格处理）：

// 在onNewConnection中替换原有的ignoreSslErrors调用
connect(pSocket, &QWebSocket::sslErrors, this, [pSocket](const QList<QSslError>& errors) {
    qDebug() << "客户端Socket SSL错误：";
    for (const auto& err : errors) {
        qDebug() << err.errorString();
    }
    // 测试环境临时忽略错误
    pSocket->ignoreSslErrors();
});

6. 启用详细日志排查 #

在服务端的onWebSocketErrorOccurred槽中输出具体错误信息，定位服务端视角的连接问题：

void WebsocketServer::onWebSocketErrorOccurred(QAbstractSocket::SocketError error) {
    QWebSocket* socket = qobject_cast<QWebSocket*>(sender());
    qDebug() << "客户端Socket错误：" << socket->errorString() << "错误码：" << error;
}

同时打开浏览器开发者工具（F12），查看Console和Network标签下的WebSocket连接详情，获取浏览器侧的具体错误提示。

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