EC2上Nginx配置Socket.IO问题咨询（MERN栈）

一、是否需要在服务端为Socket.IO配置CORS？ #

• 本地开发环境：需要。前端运行在localhost:3000，后端在localhost:5000，属于跨域场景，必须配置CORS允许前端域名才能正常建立连接。
• 生产环境：不需要（或可简化配置）。前端通过Nginx代理后，和后端接口（包括Socket.IO）属于同域名（均为yourdomain.com），浏览器不会触发跨域检查，此时服务端的CORS配置不是必需的。但如果保留CORS配置，必须确保允许生产域名，否则会导致连接失败。

二、正确配置方案（解决WebSocket持续重连问题） #

1. 调整服务端CORS配置 #

根据环境动态设置允许的Origin，避免硬编码：

// socket.js
const app = express();
const server = http.createServer(app);

// 区分开发/生产环境
const allowedOrigins = process.env.NODE_ENV === 'production' 
  ? ['http://yourdomain.com'] // 生产环境填实际域名，HTTPS则写https://yourdomain.com
  : ['http://localhost:3000'];

const io = new Server(server, {
    cors: {
        origin: allowedOrigins,
        methods: ["GET", "POST"],
        credentials: true // 如需传递Cookie等凭证则添加
    }
})
export { io, server, app }

若生产环境完全依赖Nginx代理，也可直接关闭生产环境的CORS：

const io = new Server(server, {
    cors: process.env.NODE_ENV === 'development' ? {
        origin: "http://localhost:3000",
        methods: ["GET", "POST"]
    } : false
})

2. 修正客户端Socket.IO连接代码 #

生产环境下前端与后端同域名，无需指定服务器URL，直接配置路径和参数即可：

const socket = io({
    path: '/socket.io/',
    query: {
        userId: user?._id
    }
});

你之前的写法io('/socket.io', {path: '/socket.io/'})会导致Socket.IO尝试连接当前域名/socket.io/socket.io/，路径重复是引发持续重连的核心原因之一。

3. 优化Nginx的Socket.IO代理配置 #

确保代理路径匹配，并补充必要的长连接配置：

location /socket.io/ {
    proxy_pass http://localhost:5000/socket.io/; # 显式匹配路径，避免歧义
    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-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_cache_bypass $http_upgrade;
    # 设置长连接超时时间
    proxy_connect_timeout 7d;
    proxy_send_timeout 7d;
    proxy_read_timeout 7d;
}

4. 验证配置 #

• 重启Nginx：sudo nginx -s reload
• 重启后端PM2服务：pm2 restart <你的服务名称>
• 打开浏览器开发者工具，查看Network面板的WS标签，确认WebSocket连接状态为101 Switching Protocols
• 后端控制台添加连接监听日志，验证是否收到连接事件：

  io.on('connection', (socket) => {
      console.log('用户已连接:', socket.id);
  })
  

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