insomnia中websocket连接失败需按五步排查：一、验证url协议（ws/wss）及格式；二、配置请求头与认证（origin、basic/bearer）；三、启用调试监控连接状态与心跳；四、发送匹配格式消息（text/json/binary）并验证响应；五、用脚本动态注入参数与断言。
如果您在Insomnia中配置了WebSocket请求但连接失败或消息无法正常收发，则可能是由于协议配置错误、认证缺失或服务端不可达。以下是解决此问题的步骤：
一、验证WebSocket URL与协议格式
Insomnia严格区分ws://与wss://协议，错误的协议前缀将导致连接立即终止。URL必须以合法WebSocket协议开头，且不含查询参数以外的非法字符。
1、打开Insomnia，点击左上角“+”新建请求。
2、在协议选择下拉菜单中确认已选中“WebSocket”类型。
3、在URL输入框中输入完整地址，例如：ws://echo.websocket.org 或 wss://your-api.example.com/ws。
4、检查URL末尾是否误加斜杠或空格，删除所有不可见空白符。
二、配置请求头与基础认证
部分WebSocket服务端在握手阶段校验HTTP头字段（如Origin、User-Agent）或要求携带认证凭证，缺失将被拒绝连接。
1、在请求编辑区切换至“Headers”标签页。
2、添加键值对：Origin → https://localhost:3000（若服务端校验Origin）。
3、如需Basic认证，在“Authentication”标签页中选择“Basic Auth”，填入用户名和密码。
4、如使用Bearer Token，在“Authentication”中选择“Bearer Token”，粘贴有效token字符串。
三、启用连接调试与状态监控
Insomnia提供实时连接状态面板，可定位握手失败、心跳超时或意外断连等底层问题，避免仅依赖终端日志判断。
1、点击“Connect”按钮后，观察底部状态栏颜色变化：绿色表示connected，红色表示error，灰色表示connecting。
WebSocket 8.18.2 是该协议规范的一个重要迭代版本，主要优化了连接稳定性与数据传输效率。它通过全双工通信机制，允许客户端与服务器在单一长连接上实时交换数据，大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力，适用于即时通讯、在线游戏及金融行情推送等低延迟场景，为开发者提供更可靠的实时网络交互基础。
2、连接成功后，切换至“Messages”选项卡，查看自动记录的握手请求与响应头信息。
3、在“Connection”选项卡中，确认“Ping Interval”已设为非零值（如30秒），并检查“Auto-reconnect on disconnect”是否启用。
4、手动点击“Send Ping”按钮，观察服务端是否返回Pong帧；若无响应，说明心跳机制未就绪或被防火墙拦截。
四、发送结构化消息并验证响应格式
WebSocket支持文本、JSON、二进制三类消息体，服务端通常只接受特定格式。发送不匹配格式将导致静默丢弃或连接关闭。
1、在消息输入框上方，从格式下拉菜单中选择对应类型：Text、JSON 或 Binary。
2、若选择JSON格式，确保输入内容为合法JSON对象，例如：{"action":"join","room":"general"}。
3、点击“Send”后，立即查看下方接收区域是否出现服务端回传消息；若无响应，尝试发送纯文本“ping”测试基础通路。
4、右键某条接收消息，选择“Copy as cURL”可导出原始帧数据，用于比对服务端文档定义的消息schema。
五、使用脚本注入动态参数与断言
Insomnia支持在WebSocket连接生命周期中执行JavaScript脚本，可用于动态生成Token、解析响应并触发条件重连，适用于OAuth或JWT鉴权场景。
1、在请求编辑区切换至“Scripts”标签页，点击“On Connect”编辑框。
2、输入脚本以动态设置Header：insomnia.request.headers['Authorization'] = 'Bearer ' + environment.token;。
3、在“On Message”脚本区添加断言逻辑：if (message.includes('welcome')) { insomnia.log('✅ Connection confirmed'); }。
4、在“On Error”脚本中插入日志输出：insomnia.log('❌ WebSocket error:', error);。
