Socket.io v3.1.2两端connection事件不触发且请求404如何解决

核心问题原因 #

Socket.io 绑定到了你手动创建的 http.Server 实例上，但你实际启动监听端口时使用的是 Express 的 app.listen 方法，该方法内部会创建一个全新的 HTTP 服务实例，你绑定了 Socket.io 的旧实例并没有真正启动监听，因此 /socket.io 路径的请求全部返回404，连接自然无法建立。

修复步骤 #

1. 修改服务启动代码
   将原服务启动代码：

app.listen(config.PORT, async () => {
  await connect();
  console.log(`server started on port ${config.PORT}`);
});

替换为：

server.listen(config.PORT, async () => {
  await connect();
  console.log(`server started on port ${config.PORT}`);
});

修改后，你绑定了 Socket.io 的 HTTP 服务实例会直接监听对应端口，Socket.io 的路由规则会正常生效。

2. 可选：补充 Socket.io 跨域配置（避免后续跨域报错）
   Socket.io 3.x 及以上版本默认开启严格跨域校验，如果你后续客户端和服务端部署地址不同，可在初始化时添加跨域配置，将原初始化代码：

const io = require("socket.io")(server);

修改为：

const io = require("socket.io")(server, {
  cors: {
    origin: "*" // 生产环境请替换为实际客户端地址
  }
});

其他优化点 #

• 你的服务端代码中重复配置了两次 express.json、cors、morgan 等中间件，可删除重复的配置段，避免冗余执行。
• 客户端代码中 connect 事件的回调没有入参，你当前写的 function (socket) 拿到的参数实际为 undefined，如需操作 Socket 实例直接使用外层声明的 socket 变量即可。

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