Socket.io客户端连接失败，求助服务器origin正确配置方式

问题背景 #

本地网络环境下运行Socket.IO服务器与客户端，无外部域名访问权限。服务器基于端口3000的HTTP服务器启动，客户端以Node.js脚本形式直接发起连接，无需HTTP服务器。使用DEBUG=engine,socket.io* node调试客户端时，日志显示连接被强制关闭，需调整服务器端origin配置并排查潜在版本兼容问题。

服务器代码 #

this.io = new Server(HTTPServer, {
            wsEngine: eiows.Server,
            cors: {
                origin: process.env.SOCKET_ORIGIN,
                methods: ["GET", "POST"],
                credentials: true,
                transports: ['websocket', 'polling']
            },
            allowEIO3: true,
            parser
        });

客户端代码 #

const { io } = require("socket.io-client");
this.socket = io(process.env.SOCKET_SERVER, {
            withCredentials: true,
        });

解决方案 #

1. 正确配置CORS的origin #

由于客户端是Node.js脚本（非浏览器环境），发起的请求不存在浏览器同源限制，但服务器端的CORS配置仍需允许此类请求：

• 直接设置origin: "*"，允许所有来源的请求：

  cors: {
      origin: "*",
      methods: ["GET", "POST"],
      credentials: true,
      transports: ['websocket', 'polling']
  }
  

• 更严谨的方式：通过函数允许无origin的请求（Node.js客户端请求的origin为undefined）及本地地址：

  cors: {
      origin: (origin, callback) => {
          if (!origin || origin.startsWith('http://localhost') || origin.startsWith('http://127.0.0.1')) {
              callback(null, true);
          } else {
              callback(new Error('Not allowed by CORS'));
          }
      },
      methods: ["GET", "POST"],
      credentials: true,
      transports: ['websocket', 'polling']
  }
  

2. 排查parser版本兼容性 #

问题根源涉及parser配置，需确保服务器端使用的parser与客户端Socket.IO版本完全兼容：

• 若服务器端自定义引入了parser，需确认其版本与客户端的socket.io-client版本匹配（例如Socket.IO v4对应使用socket.io-parser v4.x版本）。
• 若无需自定义parser，可直接移除parser配置项，使用Socket.IO默认的parser，避免版本不匹配导致的协议解析错误。

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