Socket.IO房间加入/离开功能仅间歇性生效问题求助

核心问题：路由重复注册导致的逻辑混乱 #

你把Express的/api/game和/api/game/join路由定义放在了Socket.IO的connection回调里——这是致命错误。每有一个客户端建立socket连接，就会重复注册一次这两个路由。当多个客户端连接后，同一个HTTP请求会被多个叠加的路由处理函数同时执行：可能用旧的socket实例执行join，也可能当前socket的操作被覆盖，直接导致了房间操作的间歇性失效，以及leave方法无效的问题。

之前代码能正常运行，只是因为初期连接量少，重复注册的路由还没累积到引发冲突的数量，随着连接增多，路由处理函数堆积，问题就显现了。

修复步骤 #

1. 把Express路由移到全局作用域

绝对不能在io.on('connection')里注册路由，要把路由定义放在全局，和socket连接逻辑分离。

2. 建立用户与socket实例的映射

要在路由中操作对应用户的socket，需要维护一个用户ID到socket实例的映射表，在socket连接时绑定，断开时清理。

修改后的完整示例代码 #

const http = require('http')
const server = http.createServer(app)
const { Server } = require('socket.io')
const io = new Server(server)

// 全局维护用户ID到socket实例的映射
const userSocketMap = new Map()

// 把路由移到全局，不再放在connection回调内
app.post('/api/game', async (req, res) => {
  const userId = req.id // 这里假设req.id是你的用户UUID
  const targetSocket = userSocketMap.get(userId)
  
  if (!targetSocket) {
    return res.status(400).send('用户未建立socket连接')
  }

  // 执行房间加入操作
  targetSocket.join(userId)
  // 其他业务逻辑
  res.send(userId)
})

app.put('/api/game/join', async (req, res) => {
  const userId = req.id
  const targetSocket = userSocketMap.get(userId)
  const roomId = req.body.room.id

  if (!targetSocket) {
    return res.status(400).send('用户未建立socket连接')
  }

  targetSocket.join(roomId)
  // 现在执行leave会生效，因为操作的是当前用户的socket实例
  targetSocket.leave('lobby')
  res.send(roomId)
})

// Socket连接处理逻辑
io.on('connection', (socket) => {
  // 从握手信息中获取用户ID（根据你的实际登录逻辑调整，比如token解析、cookie）
  const userId = socket.handshake.query.userId
  if (userId) {
    userSocketMap.set(userId, socket)
  }

  // 大厅加入逻辑保持不变
  socket.join('lobby')

  // 断开连接时清理映射，避免内存泄漏
  socket.on('disconnect', () => {
    if (userId) {
      userSocketMap.delete(userId)
    }
  })
})

额外说明 #

• socket.join和socket.leave是同步方法，不需要加await，之前加await完全没用。
• 可以在connection回调里打印日志，看看路由被注册的次数，就能直观看到之前重复注册的问题。
• 验证时可以在路由里打印targetSocket.id，确认操作的是当前用户的socket实例。

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