调试

WebSocket调试

调试 WebSocket 连接和消息。

Cool Request 支持在 IDEA 中直接调试 WebSocket 服务。你可以在功能窗口中输入 wswss 地址建立连接,发送消息并实时查看服务端返回内容,适合调试长连接、推送、实时通知等场景。

使用流程

  1. 打开 Cool Request 功能窗口。
  2. 在调试类型中选择 WebSocket
  3. 输入 WebSocket 地址,例如 ws://localhost:8080/wswss://example.com/ws
  4. 点击连接按钮,等待连接建立。
  5. 在消息输入区域填写要发送的内容。
  6. 点击发送,查看消息列表中的发送记录和接收记录。
视频加载中

消息显示

WebSocket 调试窗口会记录当前会话中的消息。为了便于排查问题,可以按消息方向筛选显示内容:

  • 显示全部消息:同时查看发送消息和接收消息。
  • 只显示发送消息:仅查看客户端主动发送的内容。
  • 只显示接收消息:仅查看服务端推送或响应的内容。

这个筛选只影响消息列表的展示,不会影响实际连接和消息收发。

适用场景

  • 调试实时通知、聊天、推送等 WebSocket 服务。
  • 验证连接地址、鉴权参数或请求头配置是否正确。
  • 检查客户端发送消息后,服务端是否按预期返回数据。
  • 排查服务端主动推送消息的内容和时机。

调试建议

  • 如果连接失败,先确认地址协议是否正确,普通连接使用 ws://,加密连接使用 wss://
  • 调试需要鉴权的 WebSocket 服务时,确认 token、Cookie 或其他鉴权参数已经按服务端要求传入。
  • 排查大量消息时,可以切换为只显示发送消息或只显示接收消息,减少干扰。