WebSocket 在线测试（ws/wss 客户端）

WebSocket 在线测试速查

什么是 WebSocket 在线测试工具？

09:30:01.204 · Connecting to ws://localhost:8080/ws
09:30:01.219 · Connected · subprotocol: chat
09:30:02.517 → TXT 17 B {"type":"hello"}
09:30:02.531 ← TXT 25 B {"type":"hello","ok":true}
09:30:03.002 → BIN 4 B 48 69 00 FF
09:30:03.010 ← BIN 4 B 48 69 00 FF
09:30:09.880 · Closed · code 4001: application-defined code

WebSocket 在线测试工具的功能

ws在线测试示例：本地服务、二进制、关闭码、Socket.IO

ws://localhost:8080/ws

已连接
→ TXT 17 B {"type":"hello"}
← TXT 25 B {"type":"hello","ok":true}

48 69 00 FF

→ BIN 4 B 48 69 00 FF

服务器以关闭码 4001、原因「token expired」关闭连接

已关闭 · 关闭码 4001：应用自定义的关闭码 · 正常完成关闭握手
原因：token expired

协议选 Socket.IO v3/v4，地址 ws://localhost:3000

正在连接 ws://localhost:3000/socket.io/?EIO=4&transport=websocket
← 0{"sid":"…","pingInterval":25000,…}
→ 40
← 40{"sid":"…"}

WebSocket 在线测试怎么用

1. 1

   填入服务器地址

   输入或粘贴 ws:// 或 wss:// 地址；http:// 和 https:// 会按 ws:// 和 wss:// 处理。留意地址下方的提示：浏览器可能拦截时会提前说明。

2. 2

   需要时填写子协议

   有的服务器要求子协议，例如 mqtt。可以填一个或多个，用逗号分隔；连上后日志会显示服务器确认了哪一个。

3. 3

   点「连接」

   在 Chrome 里连 localhost 或局域网地址时，弹出「访问本地网络」询问请选「允许」。连接失败时按出现的排查清单逐项检查。

4. 4

   收发消息

   选择文本、HEX 或 Base64，确认预览后按 Ctrl+Enter 发送。收到的 JSON 自动格式化，二进制按 HEX 显示，可在日志工具栏切换为 Base64。

5. 5

   过滤，然后复制或导出

   按方向过滤或搜索日志，消息刷屏时可暂停显示；最后把日志复制或导出为文本，带时间戳、方向和字节数。

WebSocket 连接常见错误

ws://api.example.com/ws

wss://api.example.com/ws

文本模式：48 69 → TXT 5 B

HEX 模式：48 69 → BIN 2 B

ws://localhost:3000

ws://localhost:3000/socket.io/?EIO=4&transport=websocket

Authorization: Bearer eyJ…

wss://api.example.com/ws?token=eyJ…

什么时候用在线 WebSocket 测试

后端接口自测

前端还没写，先确认新的 WebSocket 路由能连上，看它最先推送什么，以及收到异常输入时怎么处理。

排查 Nginx / 网关反代

放在 Nginx 或网关后面时，看升级请求是否转发成功，空闲连接能保持多久。

物联网与二进制协议

通过 WebSocket 传二进制的设备和消息代理，可以按 HEX 查看，并用 HEX 或 Base64 精确发送字节。

复现关闭码

看服务器实际发出的关闭码和原因，例如 token 过期、客户端被限流时。

高频推送时的显示

服务器每秒推约 2,000 条消息时（实测），页面依然流畅，并统计收发条数和字节数。

浏览器里的 WebSocket 连接原理

握手过程

WebSocket 连接以一个带 Upgrade: websocket 的 HTTP 请求开始。请求头由浏览器自己生成——Origin、Sec-WebSocket-Key、Sec-WebSocket-Version: 13，以及按子协议列表生成的 Sec-WebSocket-Protocol——网页不能添加别的头。服务器回 101 Switching Protocols 之后，双方开始收发消息。

文本消息与二进制消息

send() 传字符串发出 UTF-8 文本消息，传字节发出二进制消息。网页收到的是完整消息，看不到帧、分片和掩码。本工具把 binaryType 设为 arraybuffer，二进制消息按顺序到达并能按 HEX 显示。

为什么错误没有细节

WebSocket 规范禁止浏览器告诉脚本连接为什么失败——域名解析失败、端口被拒、证书错误、HTTP 401 在网页看来完全一样——以防网页借此探测你的内网。网页只能看到一个 error 事件和关闭码 1006（Firefox 会把证书错误报成 1015）。

混合内容与本地网络访问

HTTPS 页面不能连接公网主机的不加密 ws://。Chrome 147 起，WebSocket 也纳入「本地网络访问」：公网页面连本机或私有 IP 需要你授权。Firefox 对回环地址放行，Safari 不放行（截至 2026 年 10 月）。

关闭码

客户端主动关闭时只能用 1000 或 3000–4999，原因最长 123 字节（UTF-8）。1005（没有关闭码）和 1006（异常关闭）不会出现在网络上，是浏览器报告用的；1015 只有部分浏览器在 TLS 失败时报告。

WebSocket 测试技巧

本机以外一律用 wss://

证书受信任的 wss:// 在各浏览器里都能从本页连接公网服务器，也能保护 URL 里的 token；连本机或局域网时，Chrome 同样会先询问本地网络权限。不加密的 ws:// 留给 localhost。

握手失败先看控制台

网页只看得到 1006。Chrome 和 Edge 会在控制台打印 HTTP 状态码，通常能直接看出是鉴权、路径还是代理的问题。

在服务器上放行 Origin

浏览器总会发送 Origin。服务器校验 Origin 时，测试期间放行 https://go-tools.org；WebSocket 不走 CORS，加 CORS 头没有用。

让服务器发 ping

要让空闲连接穿过代理不被断开，请让服务器发 ping 帧，浏览器会自动回应。只有协议本身需要应用层消息时，才用定时发送。

分享日志前去掉 token

地址里常带 token。工具只把地址和消息放在内存里，但导出的日志和截图会包含它们，分享前请删掉敏感信息。

WebSocket 在线测试常见问题