WebSocket 在线测试

什么是 WebSocket 在线测试？

WebSocket 是一种在单个 TCP 连接上进行全双工通信的网络协议。与 HTTP 的请求-响应模式不同，WebSocket 建立连接后，客户端和服务器可以随时主动向对方发送数据，无需重新建立连接。它广泛用于实时聊天、在线游戏、实时数据推送、股票行情等场景。

WebSocket 在线测试工具让你可以直接在浏览器中连接到 WebSocket 服务器，发送和接收消息，实时查看通信日志。这对于开发调试 WebSocket 服务端非常有用，无需编写客户端代码即可验证服务是否正常工作。

为什么需要 WebSocket 在线测试工具？

WebSocket 开发调试中经常需要快速测试连接和消息：

• 调试 WebSocket 服务：在开发和部署 WebSocket 服务时，需要快速验证连接和消息收发
• 测试实时推送：验证服务器是否正确推送消息到客户端
• 排查连接问题：检查连接建立、握手、断开等过程中的错误
• 验证消息格式：确认 JSON 格式的消息是否正确发送和解析
• API 联调：前后端联调时，模拟客户端发送各种消息测试服务端行为

使用 IqsBot WebSocket 在线测试工具，你可以快速连接到任何 WebSocket 服务器，发送文本或 JSON 消息，实时查看通信记录。

相比其他在线 WebSocket 工具，IqsBot 的核心优势是纯浏览器端运行——消息数据不会经过中间服务器，你的浏览器直接与目标 WebSocket 服务建立连接。

如何使用 IqsBot WebSocket 在线测试工具

基础用法

1. 在「服务地址」输入 WebSocket URL（如 ws://127.0.0.1:8080/ws 或 wss://echo.websocket.org）
2. 可选填子协议（逗号分隔多个协议名）
3. 点击「连接」按钮建立 WebSocket 连接
4. 连接成功后，在左侧「发送消息」区域输入消息内容
5. 点击「发送」或按 Ctrl+Enter 快捷发送
6. 右侧「消息记录」区域实时显示发送和接收的消息

高级功能

• 多种消息格式：支持纯文本和 JSON 两种发送格式，JSON 模式自动校验格式
• 连接状态指示：实时显示连接状态（未连接、连接中、已连接、断开中）
• 消息过滤：可按全部、仅接收、仅发送、系统消息过滤日志
• 自动滚动：新消息到来时自动滚动到底部
• 日志导出：将通信记录导出为文本文件，便于分析和存档
• 快捷预设：提供 Echo 测试和本地示例两个快捷预设
• Ctrl+Enter 快捷发送：支持键盘快捷键快速发送消息
• Ping 测试：一键发送 Ping 消息，测试连接是否存活

使用示例

示例1：测试 Echo 服务器

1. 点击「Echo 测试」预设，自动填入 wss://echo.websocket.org
2. 点击「连接」，状态变为绿色「已连接」
3. 在发送区域输入 Hello WebSocket!
4. 点击「发送」
5. 消息记录中显示：发送 Hello WebSocket!，接收 Hello WebSocket!（Echo 服务器会原样返回）
6. 点击「断开」结束连接

示例2：测试本地 WebSocket 服务

1. 在服务地址输入 ws://127.0.0.1:8080
2. 切换发送格式为 JSON
3. 输入 {"type": "ping", "time": 1234567890}
4. 连接后发送，查看服务端返回的消息

常见问题

Q: 连接失败怎么办？

A: 常见原因包括：目标服务未启动、地址错误、端口被防火墙拦截、服务不允许跨域 WebSocket 连接。浏览器端 WebSocket 连接受 CORS 策略影响，部分服务仅允许同源连接。检查目标服务是否开启了 WebSocket 支持和跨域配置。

Q: ws:// 和 wss:// 有什么区别？

A: ws:// 是未加密的 WebSocket 连接，类似于 HTTP。wss:// 是加密连接（基于 TLS），类似于 HTTPS，数据传输更安全。在生产环境中建议使用 wss://。注意：部分浏览器可能要求 HTTPS 页面才能连接 wss://。

Q: 支持发送二进制消息吗？

A: 当前版本主要支持文本消息的发送和接收。如果服务器发送二进制数据（ArrayBuffer），工具会尝试解码并显示。完整的二进制消息发送支持可能在后续版本中添加。

Q: 消息记录会丢失吗？

A: 消息记录保存在页面内存中，刷新页面或关闭浏览器后会丢失。如果需要保存通信记录，请使用「导出」功能将日志下载为文本文件。日志最多保留最近 500 条。

Q: 可以同时连接多个 WebSocket 服务吗？

A: 当前版本支持同时只连接一个 WebSocket 服务。如需测试多个服务，请断开当前连接后再连接新的服务。通信记录在断开后会保留。

Q: 我的数据会上传到 IqsBot 服务器吗？

A: 不会。IqsBot 的 WebSocket 测试工具是你的浏览器直接与目标 WebSocket 服务建立连接，所有消息数据在浏览器和目标服务之间直接传输，不经过 IqsBot 的任何服务器。