hoppscotch websocket调试需五步：一、验证ws/wss端点并确认协议选中；二、在protocols页添加并激活子协议（如graphql-ws）；三、在communication面板发送合法json/文本消息，观察双向日志；四、通过connectionstate状态机识别connecting/connected/error/disconnected故障节点；五、关闭系统代理、忽略ssl错误（测试环境）、检查network中upgrade头及控制台websocket实例。
如果您在使用Hoppscotch调试WebSocket服务时无法建立稳定连接、消息收发异常或协议不生效，则可能是由于端点配置错误、子协议未激活、网络策略拦截或状态监听缺失所致。以下是解决此问题的步骤：
一、验证并配置WebSocket端点
正确输入符合RFC 6455规范的ws/wss URL是建立连接的前提，Hoppscotch会在提交前通过Web Worker异步校验URL格式与协议合法性，避免主线程阻塞。
1、点击左侧导航栏的Realtime选项，进入实时通信模块。
2、在协议选择器中确认已选中WebSocket而非SSE或Socket.IO。
3、在地址栏输入完整端点URL，例如wss://echo.websocket.events或ws://localhost:8080/ws，注意不可省略协议前缀。
4、点击Connect按钮，观察右上角状态指示器是否流转至CONNECTING，再变为CONNECTED。
二、启用并排序子协议（Protocols）
子协议用于协商应用层语义（如graphql-ws、soap），若服务端要求特定协议但客户端未声明，连接可能被拒绝或消息解析失败。
1、切换至Protocols标签页。
2、点击Add Protocol按钮，输入服务端要求的协议名称，例如graphql-ws。
3、勾选该协议项右侧的Active开关，确保其处于启用状态。
4、如需多协议支持，可通过拖拽调整顺序，Hoppscotch将按从上到下的优先级注入Sec-WebSocket-Protocol请求头。
三、发送结构化消息并验证双向日志
消息内容格式必须与服务端预期一致，JSON需为合法对象/数组，文本需无BOM且编码为UTF-8，否则可能导致解析中断或连接重置。
1、在Communication面板左侧输入框中，选择JSON或Text模式。
2、输入有效载荷，例如JSON模式下输入：{"action":"ping","id":1}。
3、点击Send按钮，检查右侧日志区是否立即出现带时间戳的发送记录及对应接收响应。
4、确认每条日志含方向标识——→表示发送，←表示接收。
四、检查连接状态机与异常捕获
Hoppscotch通过响应式变量connectionState精确映射底层WebSocket实例的四个标准状态，可据此定位连接生命周期中的具体故障节点。
1、观察界面顶部中央的状态标签，识别当前值是否为CONNECTING、CONNECTED、DISCONNECTED或ERROR。
2、若长期停留于CONNECTING，检查浏览器控制台是否有SecurityError或Network Error。
3、若突变为ERROR，展开浏览器开发者工具的Console面板，查找以WebSocket connection to ... failed开头的报错。
4、若显示DISCONNECTED且无主动断开操作，检查服务端是否返回了非1000的关闭码（如1006代表连接异常终止）。
五、绕过代理与启用调试模式
企业网络或本地开发环境常部署HTTP代理或HTTPS拦截工具，可能干扰WebSocket升级请求（Upgrade: websocket头被过滤或证书校验失败）。
1、在Hoppscotch设置中关闭Use system proxy选项。
2、若使用wss连接且提示证书错误，临时启用Ignore SSL certificate errors（仅限测试环境）。
3、打开浏览器开发者工具的Network标签页，筛选WS类型请求，查看Headers中是否存在Upgrade: websocket及Connection: Upgrade字段。
4、在Console中执行window.hoppscotchStore.state.realtime.webSocketSession.socket，直接访问底层WebSocket实例，调用close()或检查bufferedAmount值。
