Socket.io客户端连接Nginx反向代理服务端后立即触发connect_error持续重连

核心错误原因及修复方法按优先级排列如下： #

• 客户端连接配置错误 #

  Socket.io 的连接 URL 仅用于指定服务端地址，path参数需要单独在配置项中声明，你当前将/socket.io拼接在URL中的写法会被识别为命名空间而非资源路径，修正代码：

  io = require("socket.io-client");
  const socket = io.connect("https://api.messboot.at", {
    transports: ["websocket"],
    path: "/socket.io"
  });
  

• 服务端配置错误 #

  1. 传输协议配置项拼写错误：正确参数名为复数形式的transports，你写的transport为无效参数，不会生效
  2. 缺失跨域配置：NestJS WebSocket服务默认会拦截跨域请求，需要手动添加CORS配置
     修正后的服务端网关配置：

  @WebSocketGateway(8000, {
    transports: ['websocket'], // 修正拼写
    allowUpgrades: false,
    cors: {
      origin: "*" // 可替换为实际客户端域名限制访问
    }
  })
  

• Nginx反向代理配置缺失 #

  WebSocket连接需要Nginx额外配置协议升级相关的请求头，否则会在握手完成后被主动断开，对应location配置参考：

  location /socket.io {
    proxy_pass http://<你的Socket.io服务内网地址>:8000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_buffering off;
    proxy_read_timeout 3600s;
  }
  

• Socket.io版本不兼容 #

  Socket.io v2与v3/v4大版本之间完全不兼容，是该类问题的高发原因，你可以分别核对客户端和服务端的Socket.io版本，保证大版本一致即可：
  客户端执行命令查看版本：npm list socket.io-client
  服务端执行命令查看版本：npm list socket.io

• 定位精准根因 #

  你可以修改客户端错误日志的打印内容，查看完整错误信息快速定位问题：

  socket.on("connect_error", (error) => {
    console.log("连接错误详情：", error.message, error.stack);
  });
  

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