React客户端对接Socket.io服务端时namespace连接无法触发问题求助

安全阿岳

2026-10-1

问题排查与解决方案

核心错误点

你代码里第一个最明显的问题是客户端请求的命名空间与服务端注册的命名空间不匹配：

客户端连接地址为 http://localhost:3001/poker，请求的是 /poker 命名空间
服务端仅注册了 /test 命名空间的连接监听，自然不会触发对应回调

分步解决方法

第一步：统一命名空间名称
二选一修改即可：
1. 调整客户端连接地址，改为请求/test命名空间：
```
const testSocket = io(`http://localhost:3001/test`);
```
1. 调整服务端命名空间注册，改为监听/poker命名空间：
```
const pokerNamespace = io.of("/poker");
pokerNamespace.on('connection', socket => {
  console.log("here2");
});
```

第二步：配置服务端跨域规则
Socket.io v3及以上版本默认开启严格跨域校验，未配置的情况下会拒绝连接，自动降级为轮询模式反复重试。修改服务端Socket.io初始化代码：

const { Server } = require("socket.io");
const io = new Server(3001, {
  cors: {
    origin: "http://localhost:3000", // 替换为你的React客户端实际访问地址
    credentials: true
  },
  transports: ["websocket", "polling"] // 显式声明支持的传输方式
});

第三步：客户端显式指定传输优先级
避免默认先发起轮询请求的逻辑，优先使用WebSocket协议：
```
const testSocket = io(`http://localhost:3001/test`, {
  transports: ['websocket', 'polling']
});
```
第四步：确认命名空间注册时机
确保服务端io.of()的注册逻辑是在Socket.io实例初始化完成后、服务启动前执行，不要放在根命名空间的connection回调内部。