本文解析 Socket.IO 中 leave-room 事件被多次触发的根本原因——事件监听器在每次连接时被重复注册，并提供标准、安全的监听方案，避免内存泄漏与逻辑错乱。
本文解析 socket.io 中 `leave-room` 事件被多次触发的根本原因——事件监听器在每次连接时被重复注册，并提供标准、安全的监听方案，避免内存泄漏与逻辑错乱。
在 Socket.IO 服务端开发中，io.sockets.adapter.on("leave-room", ...) 是一个全局适配器级事件监听器，用于捕获所有客户端离开房间（包括因断开连接而自动退出默认房间）的行为。但若将其错误地置于 io.on("connection", ...) 回调内部，就会导致每次新客户端连接时，都新增一个独立的监听函数实例。
由于该监听器未被销毁或去重，随着连接数增加，监听器数量线性增长：第 1 次连接后有 1 个监听器，第 2 次后变为 2 个，第 n 次后为 n 个——因此 console.log('socket X left room Y') 会被重复执行 n 次，造成日志爆炸与潜在性能问题。
✅ 正确做法：监听器必须声明在连接事件之外
监听器应作为单例初始化逻辑，仅注册一次，在服务启动时完成，而非随每个 socket 实例动态挂载：
// ✅ 正确：全局仅注册一次
io.sockets.adapter.on("leave-room", (room, id) => {
console.log(`socket ${id} left room ${room}`);
});
// 连接事件中仅处理 socket 级逻辑（如加入房间、发送欢迎消息等）
io.on("connection", (socket) => {
console.log("connected socket", socket.id);
// 示例：客户端加入自定义房间
socket.join("lobby");
// 示例：监听该 socket 的断开事件（非 leave-room）
socket.on("disconnect", (reason) => {
console.log(`socket ${socket.id} disconnected: ${reason}`);
});
});⚠️ 注意事项与最佳实践
- 不要在 connection 回调内注册 adapter 级事件：io.sockets.adapter.on(...) 属于服务器级生命周期事件，与具体 socket 实例无关，重复注册将直接导致事件放大。
-
区分 disconnect 与 leave-room：
- socket.on("disconnect")：响应当前 socket 主动断开或异常掉线；
- "leave-room"：响应任意 socket 调用 socket.leave(room) 或因断连自动退出房间（包括默认的 socket.id 房间）。二者语义不同，不可混用。
- 避免内存泄漏风险：若需动态监听/卸载 adapter 事件（极少数场景），请保存监听器引用并手动 off()，但绝大多数应用无需如此——全局监听一次即足够。
- 验证是否已修复：重启服务后，执行多次连接 → 断开操作，观察控制台输出是否恒为单条 socket X left room Y，即可确认问题解决。
? 补充说明：为何首次只输出 1 条？
首次连接时，监听器仅注册 1 次，故 leave-room 触发 1 次；第二次连接时，监听器已被注册 2 次（第一次未清除），因此同一事件被两个函数同时响应——这正是事件重复的核心机制。Socket.IO v4.7.1 及后续版本中，该行为保持一致，不构成 bug，而是开发者误用 API 所致。
遵循“监听器单次初始化”原则，即可彻底规避该问题，保障服务稳定性与可观测性。
