如何利用SocketIO房间实现用户上下线状态并向管理员推送事件？

这个思路非常靠谱——用用户专属房间统计在线客户端数量，完美解决了多标签页场景下connect/disconnect频繁触发导致的状态误判问题。下面以Socket.IO为例，给你一步步拆解实现细节：

1. 基础准备：用户身份绑定与专属房间创建 #

首先，你需要确保每个连接的客户端都能传递唯一的用户标识（比如登录后的user_id）。可以通过连接时的query参数、JWT令牌验证等方式获取这个ID，避免非法用户混入房间。

当用户成功连接并验证身份后，让其加入以自身ID命名的专属房间：

// 服务器端代码
io.on('connection', async (socket) => {
  // 假设通过socket.handshake.query获取用户ID，或通过JWT验证后拿到
  const userId = socket.handshake.query.userId;
  
  if (!userId) {
    socket.disconnect(); // 无合法身份直接断开
    return;
  }

  // 加入用户专属房间
  socket.join(`user:${userId}`);
  
  // 后续逻辑...
});

2. 上线事件触发：房间从空到有第一个客户端 #

当用户加入房间后，立即统计房间内的客户端数量。如果数量恰好为1，说明这是该用户的第一个在线连接（用户刚上线），此时向管理员发送上线通知：

// 接上面的连接逻辑
const userRoom = `user:${userId}`;
const clientCount = io.sockets.adapter.rooms.get(userRoom)?.size || 0;

if (clientCount === 1) {
  // 向管理员发送上线事件
  // 假设管理员都加入了"admin-room"专属房间
  io.to('admin-room').emit('user-online', {
    userId,
    username: "用户昵称（可选）",
    timestamp: new Date().toISOString()
  });
}

3. 下线事件触发：延迟验证房间是否为空 #

用户断开连接时，不能立即判断为离线——因为可能只是刷新标签页（旧连接断开，新连接马上建立）。所以需要加一个短暂延迟，等所有可能的重连/新连接完成后，再检查房间内的客户端数量：

// 服务器端：监听客户端断开事件
socket.on('disconnect', () => {
  const userRoom = `user:${userId}`;
  
  // 延迟1秒（可根据业务调整）后检查房间状态
  setTimeout(() => {
    const updatedClientCount = io.sockets.adapter.rooms.get(userRoom)?.size || 0;
    
    if (updatedClientCount === 0) {
      // 房间已空，确认用户离线，发送下线通知给管理员
      io.to('admin-room').emit('user-offline', {
        userId,
        username: "用户昵称（可选）",
        timestamp: new Date().toISOString()
      });
    }
  }, 1000);
});

4. 管理员端的接收逻辑 #

管理员登录后，需要让其加入admin-room，这样才能接收到上下线通知：

// 管理员客户端连接时（服务器端）
io.on('connection', (socket) => {
  // 验证用户是否为管理员（比如通过数据库查询角色）
  const isAdmin = await checkIfUserIsAdmin(socket.handshake.query.userId);
  
  if (isAdmin) {
    socket.join('admin-room');
    
    // 可选：管理员上线时，可同步当前所有在线用户列表
    const onlineUsers = getOnlineUsers(); // 自己实现的统计逻辑
    socket.emit('initial-online-users', onlineUsers);
  }
});

关键注意事项 #

• 延迟时长调整：1秒是通用值，如果你的业务中用户重连/刷新的延迟更高，可以适当延长（比如2秒），避免误判离线。
• 房间名唯一性：确保用户ID是全局唯一的，房间名用user:${userId}这种格式，避免和其他业务房间冲突。
• 异常处理：比如用户身份验证失败、房间获取失败等场景，要做兜底处理，避免服务器报错。

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