中文

WebSocket 在线测试

在浏览器中调试 WebSocket。连接 WS/WSS,发送 JSON 或文本,并查看实时收发日志。

本工具会连接到你填写的地址。消息发往该服务器,不会经过 Toolbox.Hub。

未连接


适用场景与使用建议

开发和测试可检查聊天、实时通知、看板更新或设备上报通道,运维可辅助观察某个端点能否连接及是否返回预期消息。它不自动理解业务协议,也不是后台监控或消息长期存储系统。

连接、发送并查看消息

  • 连接 ws:// 与 wss://
  • 发送文本或 JSON,保留实时日志
  • 可选心跳与子协议

如何调试 WebSocket

  1. 填写目标 WebSocket 地址;本站为 HTTPS,应使用 wss://。如果服务要求子协议,按服务端约定填写,不要把 HTTP 接口地址当成 WebSocket 地址。
  2. 点击连接,确认状态变为已连接,再发送消息。连接失败时先检查地址、证书、服务可达性、Origin 限制和认证方式;浏览器往往只给有限错误信息。
  3. 在消息框输入文本或 JSON,按发送按钮或直接回车发送,Shift+Enter 可换行。JSON 美化只调整格式,不会自动满足服务器的消息协议。
  4. 按服务要求选择是否启用心跳、间隔和内容。查看带方向、时间与字节数的收发日志,必要时复制日志;页面只保留最近 400 条。
  5. 测试完成点击断开。页面会在本地记住连接地址,但不保存完整会话历史;下次使用前检查地址是否仍适合当前测试环境。

WebSocket 调试常见问题

除了聊天应用,还适合测试哪些实时服务?

可测试消息通知、设备状态、实时看板或协作服务中的标准 WebSocket 端点,前提是你了解它的消息格式与认证方式。工具只提供通用浏览器连接,不会自动实现 MQTT、Socket.IO 或其他应用层握手;协议名称相似不代表可直接互通。

为什么命令行能连,浏览器里却失败?

浏览器受 HTTPS 混合内容、证书、Origin 检查及请求头能力限制。它不允许像某些命令行客户端一样随意设置握手请求头。先查看浏览器开发者工具与服务端日志,区分服务拒绝、认证失败和地址不可达,不要只反复点击连接。

可以设置 Authorization 请求头或任意自定义头吗?

当前基于浏览器原生 WebSocket API,不提供任意请求头设置。认证应遵循服务本身支持的浏览器方案,例如受支持的会话或协议机制;不要假设把令牌放进任意位置都有效。输入地址会被本地记住,含敏感查询参数时也应考虑这点。

心跳是不是协议层 ping,日志会永久保存吗?

这里的心跳按设定间隔发送普通文本消息,不是可自定义控制帧的协议层 ping。服务端必须理解该文本才有意义。日志只保留当前页面最近 400 条,不提供后台长期存储;需要留存时及时复制,结束后主动断开连接。

更多开发者工具