WebSocket 接口测试使用说明

这是一个纯浏览器端的 WebSocket 调试工具，直接使用原生 WebSocket 建立长连接，不经过任何中转服务器，你输入的地址与报文只在本机与目标服务之间传输。

1. 在“服务地址”填入完整地址，必须以 ws:// 或 wss:// 开头，例如 wss://example.com/ws?token=abc。

2. 如果服务端要求子协议，在“子协议”里填写，多个用英文逗号分隔，留空表示不指定。

3. 点击“连接”，右侧状态标签会从“连接中”变为“已连接”。

4. 在“发送内容”里写报文，点击“发送”或按 Ctrl + Enter。收发记录会带方向、时间与字节数展示在下方日志区。

很多网关会在空闲一段时间后主动断开连接。打开“心跳”开关后，工具会按设定的秒数周期性发送一条固定文本（默认 ping）。间隔与内容需要在关闭开关的状态下修改，打开后即刻生效，断开连接时自动停止。

文本视图直接显示报文字符串，适合 JSON、纯文本协议。十六进制视图把内容按 UTF-8 编码逐字节展开，每行 16 字节并附带可打印字符预览，适合排查不可见字符、编码错误、协议头字段。服务端推送二进制帧（Blob 或 ArrayBuffer）时，工具会自动读取其字节内容并按当前视图渲染。

浏览器安全策略规定：https 页面只能连接 wss，不能连接明文 ws，否则会被直接拦截且控制台报混合内容错误。如果你要测试的是本地明文服务，请在 http://localhost 环境下打开本工具，或者给服务配置 TLS 后改用 wss。

连接立刻关闭且没有任何提示：多为服务端校验失败（鉴权、Origin 白名单）或地址路径写错，可查看关闭码，1006 表示异常断开且没有收到关闭帧。

握手报 403 / 404：说明请求根本没走到 WebSocket 升级，检查反向代理是否透传 Upgrade 与 Connection 头。

发送后无响应：确认报文格式是否符合服务端约定，可先用“格式化 JSON”校验 JSON 是否合法。

跨域：WebSocket 不受同源策略限制，也不存在预检请求，但服务端可能自行校验 Origin 头，被拒绝时通常表现为握手失败。

所有日志仅存在于当前页面内存中，刷新即清空。可点击“导出日志”把完整记录保存为本地 txt 文件留档。