使用Socket.io连接admin-ui面板时出现Invalid namespace问题排查

核心问题：CORS配置不完整 #

你的Socket.io服务端仅配置了允许的origin，但admin-ui连接时需要服务端支持额外的CORS选项（凭证、HTTP方法等），预检请求失败后会触发"Invalid namespace"错误。

修复步骤 #

1. 完善CORS配置 #

修改Socket.io实例的CORS选项，补充必要的权限配置：

const io = new Server(server, {
  cors: {
    origin: ["https://admin.socket.io"],
    credentials: true, // 允许携带连接凭证
    methods: ["GET", "POST"], // 允许admin-ui所需的HTTP方法
    allowedHeaders: ["Content-Type"] // 允许必要的请求头
  },
});

2. 移除手动创建的/admin命名空间 #

instrument函数会自动创建admin-ui所需的命名空间，手动创建会导致冲突，请删除相关自定义代码。

3. 重启服务并重新连接 #

修改代码后重启Node.js服务，回到https://admin.socket.io面板，输入服务端地址（如http://localhost:3001）重新尝试连接。

验证要点 #

• 查看服务端日志，确认无CORS相关报错
• 打开浏览器开发者工具的Network面板，检查Socket.io连接请求（路径为/socket.io/?EIO=4...）返回200状态

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