Node Socket.io仅本地可用，部署到域名后无法连接求助

问题描述 #

本地环境（http://localhost:5000）中Socket.io可正常连接，但部署到HTTPS域名（示例：https://abcd.com）时，出现连接超时错误：

websocket.js:43 WebSocket connection to 'wss://abcd.com/socket.io/?EIO=4&transport=websocket' failed: WebSocket opening handshake timed out

解决方案 #

1. 修复服务端CORS配置的拼写错误 #

在.config/socket.js中，cors配置里的orgin是拼写错误，改为origin后CORS规则才能生效，HTTPS环境下浏览器才不会阻止连接：

const io = socketIO(server, {
    cors: {
        origin: "*", // 修正拼写错误
        methods: "GET,HEAD,PUT,PATCH,POST,DELETE",
        preflightContinue: false,
        optionSuccessStatus: 204,
    },
});

2. 配置反向代理（以Nginx为例） #

如果用Nginx做反向代理，必须添加WebSocket相关的头信息，确保请求能正确升级为WebSocket连接：

server {
    listen 443 ssl;
    server_name abcd.com;

    # 填写你的SSL证书路径
    ssl_certificate /path/to/your/cert.pem;
    ssl_certificate_key /path/to/your/key.pem;

    location / {
        proxy_pass http://localhost:5000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

3. 调整客户端的Transports配置 #

强制使用websocket传输可能在HTTPS环境下触发握手问题，可改为默认的自动降级策略（先尝试polling，再升级到websocket），或显式配置HTTPS相关参数：

// 推荐：使用默认传输策略
const socket = io(`${process.env.REACT_APP_BACKEND_URL}`);

// 若需强制websocket，补充secure参数
const socket = io(`${process.env.REACT_APP_BACKEND_URL}`, {
    transports: ['websocket'],
    secure: true, // HTTPS环境下显式开启secure
});

4. 检查服务端网络与端口配置 #

• 确保Node.js服务监听的端口（如5000）在服务器防火墙/安全组中开放，或通过反向代理使用80/443端口（避免非标准端口的连接限制）。
• 如果服务端直接启用HTTPS，需在创建服务器时配置SSL证书：

const https = require('https');
const fs = require('fs');

const sslOptions = {
    key: fs.readFileSync('/path/to/private-key.pem'),
    cert: fs.readFileSync('/path/to/certificate.pem')
};

const server = https.createServer(sslOptions, app);

5. 验证域名与SSL证书有效性 #

• 确认域名abcd.com已正确解析到服务器IP。
• 通过浏览器访问https://abcd.com检查SSL证书状态，无效或过期证书会直接导致WebSocket连接失败。

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