调试
WebSocket调试
调试 WebSocket 连接和消息。
Cool Request 支持在 IDEA 中直接调试 WebSocket 服务。你可以在功能窗口中输入 ws 或 wss 地址建立连接,发送消息并实时查看服务端返回内容,适合调试长连接、推送、实时通知等场景。
使用流程
- 打开 Cool Request 功能窗口。
- 在调试类型中选择
WebSocket。 - 输入 WebSocket 地址,例如
ws://localhost:8080/ws或wss://example.com/ws。 - 点击连接按钮,等待连接建立。
- 在消息输入区域填写要发送的内容。
- 点击发送,查看消息列表中的发送记录和接收记录。
消息显示
WebSocket 调试窗口会记录当前会话中的消息。为了便于排查问题,可以按消息方向筛选显示内容:
- 显示全部消息:同时查看发送消息和接收消息。
- 只显示发送消息:仅查看客户端主动发送的内容。
- 只显示接收消息:仅查看服务端推送或响应的内容。
这个筛选只影响消息列表的展示,不会影响实际连接和消息收发。
适用场景
- 调试实时通知、聊天、推送等 WebSocket 服务。
- 验证连接地址、鉴权参数或请求头配置是否正确。
- 检查客户端发送消息后,服务端是否按预期返回数据。
- 排查服务端主动推送消息的内容和时机。
调试建议
- 如果连接失败,先确认地址协议是否正确,普通连接使用
ws://,加密连接使用wss://。 - 调试需要鉴权的 WebSocket 服务时,确认 token、Cookie 或其他鉴权参数已经按服务端要求传入。
- 排查大量消息时,可以切换为只显示发送消息或只显示接收消息,减少干扰。