Socket.IO连接失败等问题可按五步排查：一、启用协议并连接服务端；二、配置命名空间与事件监听；三、发送带JSON参数的事件；四、开启debug日志追踪底层传输；五、多标签页模拟并发连接验证广播。
如果您在使用Hoppscotch调试实时功能时发现Socket.IO连接失败、事件未触发或消息收发异常，则可能是由于协议不匹配、服务端配置缺失或客户端未正确初始化所致。以下是针对Socket.IO协议的多种独立测试方法：
一、启用Socket.IO协议并连接基础服务
Hoppscotch原生支持Socket.IO协议，但需手动启用对应模块并指定兼容的服务端地址。该方式适用于已部署标准Socket.IO服务器（如Express + socket.io）的场景，依赖HTTP长轮询或WebSocket传输层自动降级机制。
1、打开Hoppscotch网页版或桌面版，点击左侧导航栏“Realtime”进入实时通信模块。
2、在协议选择器中下拉并选择Socket.IO（若未显示，请确认版本≥v2.4.0或已启用实验性协议插件）。
3、在URL输入框中填入目标Socket.IO服务端地址，例如：https://socketio-chat-h9jt.herokuapp.com（官方示例）或您自托管的地址（必须含/socket.io/路径或由服务端自动重定向）。
4、点击“Connect”按钮，观察状态栏是否显示Connected；若出现“Connection refused”或超时，请检查服务端是否启用cors并允许Hoppscotch源域名。
二、配置自定义命名空间与事件监听
Socket.IO支持多命名空间隔离通信，Hoppscotch允许用户显式指定命名空间路径及监听特定事件名，避免全局事件混淆。此方法适用于微服务架构中按业务域划分通道的调试场景。
1、建立基础连接后，在界面右上角找到“Namespace”输入框。
2、输入命名空间路径，例如：/admin 或 /notifications（必须与服务端io.of('/admin')定义一致）。
3、在“Event”字段中输入待监听的事件名称，例如：user:joined 或 message。
4、点击“Subscribe”按钮，此时日志区域将开始捕获该命名空间下匹配事件名的所有服务器推送数据。
三、发送带参数的Socket.IO事件
Socket.IO客户端常通过socket.emit(eventName, ...args)向服务端发送结构化事件。Hoppscotch提供参数化发送界面，支持JSON序列化和多参数分隔，确保与服务端签名严格对齐。
1、确保已成功连接且处于目标命名空间内。
2、在消息输入区上方切换至“Emit”模式（非“Send”或“Broadcast”）。
3、在“Event”字段填写服务端监听的事件名，例如：chat:message。
4、在“Payload”字段输入合法JSON对象，例如：{"userId":"U123","text":"Hello world","timestamp":1715128080}。
5、点击“Emit”按钮，查看日志中是否返回服务端响应事件（如ack回调或chat:message:ack等自定义应答）。
四、启用Socket.IO调试日志与底层传输跟踪
Hoppscotch集成Socket.IO客户端的debug模式，可输出原始握手请求、升级过程、心跳包及帧级数据。该方法用于诊断连接中断、重连失败或编码错误等底层问题。
1、在连接前，点击右上角齿轮图标打开设置面板。
2、勾选Enable Socket.IO debug logs选项。
3、重新执行连接操作，日志区域将显示类似socket.io-client:url parse https://...、engine.io-client:socket writing ping packet - expecting pong等详细链路信息。
4、若发现transport error或ping timeout，需检查服务端pingTimeout/pingInterval配置是否与客户端默认值（60s/25s）兼容。
五、模拟多客户端并发连接与事件广播
为验证服务端广播逻辑（如io.emit()或socket.broadcast.emit()），需在单页面内启动多个独立Socket.IO会话。Hoppscotch支持标签页级隔离连接，无需开启多个浏览器实例。
1、保持当前标签页连接状态，点击浏览器顶部标签栏右侧的“+”号新建一个Hoppscotch标签页。
2、在新标签页中重复步骤一完成第二次连接（可使用相同或不同命名空间）。
3、在第一个标签页中发送事件，例如：emit("broadcast:test", {"value": "from-tab-1"})。
4、观察第二个标签页日志区域是否实时接收到该事件；若未收到，检查服务端是否调用io.emit()而非socket.emit()。
