Flutter中使用Socket.IO接收重复消息的问题排查与解决咨询

问题定位 #

这种socket.on重复触发的情况，大概率是客户端问题——因为重启应用就能解决，说明服务端没有持续重复发送的逻辑，更可能是客户端重复注册了事件监听，或者存在多个Socket实例同时监听同一事件。当然也不能完全排除服务端偶发的重复推送，需要进一步验证。

修复方案 #

• 避免重复注册监听：确保socket.on('EVENT', (data){})只执行一次。比如在页面的initState中注册，或者用单例模式管理全局Socket实例，不要每次进入页面都重新绑定事件。
• 页面销毁时清理监听：在页面的dispose方法中调用socket.off('EVENT')，移除该事件的监听，防止页面重建（比如路由跳转返回）时重复绑定。
• 确保Socket实例唯一：检查代码中是否多次初始化了Socket连接，导致多个实例同时监听同一个事件。建议全局维护一个Socket单例，所有页面共用同一个实例。
• 服务端侧排查：如果客户端排查后问题仍存在，检查服务端是否存在重复广播的逻辑，比如是否对同一个连接多次调用了发送消息的接口，或者是否有异步逻辑导致重复触发推送。

如何获取更多排查信息 #

• 客户端添加日志：在事件监听回调中打印Socket实例ID和触发时间，判断是同一个实例重复触发还是多个实例各自触发：

  socket.on('EVENT', (data) {
    print('Socket ID: ${socket.id} | 触发时间: ${DateTime.now()} | 消息内容: $data');
  });
  

• 服务端添加日志：在发送消息的代码处，记录发送的目标Socket ID、发送时间和消息内容，确认服务端是否真的发送了两次相同的消息。
• 抓包验证通信：用网络抓包工具捕获Socket.IO的通信数据包，直接查看服务端是否发送了两次相同的消息，还是客户端重复处理了一次消息。
• 检查页面生命周期：确认是否因为页面的initState被多次调用（比如屏幕旋转、路由栈操作），导致事件监听被重复注册。

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