Socket.io服务器隔次触发断开连接且重复触发问题排查

问题现象 #

• 打开10个窗口对应5组客户端连接，逐个关闭窗口后，每个客户端ID的断开事件都会重复触发两次
• 控制台输出日志：

1521070467800 has left 
1521070467800 has left 
1521070467801 has left 
1521070467801 has left 
1521070467802 has left 
1521070467802 has left 
1521070467803 has left 
1521070467803 has left 
1521070467804 has left 
1521070467804 has left

常见原因及排查方向 #

1. 重复绑定断开事件监听器 #

这是这类问题的高发原因——如果你提到的代码段b，在每次客户端连接时重复给同一个连接实例绑定了disconnect（或同类）事件的监听器，那么当连接断开时，所有绑定的监听器都会被触发，自然会出现重复日志。

比如可能出现的错误代码场景：

// 错误示例：同一连接实例多次绑定断开事件
io.on('connection', (socket) => {
  // 代码段b可能在这里重复执行了绑定逻辑
  socket.on('disconnect', () => {
    console.log(`${socket.id} has left`);
  });
  // 不小心又绑定了一次
  socket.on('disconnect', () => {
    console.log(`${socket.id} has left`);
  });
});

更隐蔽的情况是：监听器绑定逻辑被放在了一个会被多次执行的函数里（比如某个初始化函数被异步触发了两次）。

解决方式：

• 检查代码段b，确保每个连接实例只绑定一次断开事件监听器
• 如果需要动态调整监听逻辑，可以用once代替on（适合只需要触发一次的场景），或者在绑定前先移除已有监听器：

// 先移除再绑定，避免重复
socket.off('disconnect').on('disconnect', () => {
  console.log(`${socket.id} has left`);
});

2. 客户端连接实例重复创建 #

你提到10个窗口对应5组客户端连接，有可能每个窗口内的代码不小心初始化了两次连接——比如DOM加载事件重复绑定、异步逻辑重复触发，导致一个窗口对应两个连接实例，关闭窗口时两个连接都断开，触发两次事件。

排查方式：

• 在服务端打印新连接的ID，观察每个窗口打开时是否生成两个关联的连接ID
• 检查客户端初始化连接的代码，确认是否被执行了多次

3. 服务端全局监听逻辑重复 #

如果服务端使用的框架（比如Socket.io、Net模块）存在重复注册连接状态监听的情况，也会导致事件重复触发。比如全局的connection事件监听被注册了两次，或者处理断开事件的中间件被重复挂载。

解决方式：

• 检查服务端启动代码，确保connection事件的监听只注册一次
• 排查第三方插件/中间件是否重复处理了断开事件

总结 #

结合你提到的代码段b，优先排查重复绑定事件监听器的问题——这是最容易导致该现象的原因。可以在代码段b中添加临时日志，打印每次绑定监听器时的连接实例ID，验证是否同一个实例被绑定了多次。

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