Socket.io+Nginx代理问题：WebSocket请求返回400错误排查求助

我来帮你拆解下这个Socket.io WebSocket返回400错误的排查方向——既然HTTP请求正常，问题基本出在WebSocket的握手环节，尤其是服务器端的配置或代理层面：

1. 代理配置缺失WebSocket支持 #

你提到了“代理”，这大概率是问题根源！如果生产环境用了Nginx、Apache这类反向代理，默认不会自动处理WebSocket的升级请求，导致握手被拦截或解析错误。

• 以Nginx为例，必须在对应location块中添加WebSocket转发规则：

  proxy_set_header Upgrade $http_upgrade;
  proxy_set_header Connection "upgrade";
  proxy_set_header Host $host;
  proxy_http_version 1.1;
  

  这段配置是告诉Nginx识别WebSocket的Upgrade请求头，正确将握手请求转发到后端8080端口的Socket.io服务。

2. Socket.io版本不兼容 #

Socket.io的WebSocket握手逻辑在v2和v3/v4版本间有较大差异，如果客户端和服务器版本不匹配，会直接触发400错误：

• 查看服务器端package.json中的socket.io版本，再对比客户端加载的socket.io.js版本（可在浏览器控制台的网络面板查看）。
• 比如服务器用v4但客户端还在用v2的连接写法，就会因为协议不兼容导致握手失败。

3. Socket.io初始化配置错误 #

检查服务器端的Socket.io初始化代码，有没有意外禁用WebSocket传输：

• 如果代码里设置了transports: ['polling']，那WebSocket请求会被直接拒绝，返回400。正确的配置应该确保websocket在允许的传输列表中：

  const io = require('socket.io')(server, {
    transports: ['websocket', 'polling'] // websocket优先，fallback到polling
  });
  

4. 防火墙/安全组拦截WebSocket流量 #

虽然HTTP请求能正常通过，但部分防火墙或云服务商安全组可能会过滤WebSocket的握手请求（比如校验Upgrade头的规则）：

• 可以临时关闭防火墙测试，或者查看防火墙日志，确认有没有拦截8080端口的WebSocket相关请求。

5. 握手请求头异常 #

在服务器端添加日志，打印客户端发来的WebSocket握手请求头，确认关键头是否存在：

• 比如在Node.js的HTTP服务器层面添加日志：

  server.on('upgrade', (req, socket, head) => {
    console.log('WebSocket Upgrade Headers:', req.headers);
    // 继续处理Socket.io逻辑
  });
  

  如果日志里看不到Upgrade: websocket或Connection: Upgrade，说明代理没有正确转发这些头，需要调整代理配置。

虽然你倾向服务器端，但可以花2分钟确认：

• 检查客户端连接URL是否正确：比如是不是误写了wss://（如果服务器没配置SSL的话要用ws://），端口是不是8080。
• 确认客户端没有强制禁用WebSocket传输：比如有没有设置transports: ['polling']。

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