连接 ws:// 或 wss:// 地址,发送文本、JSON 或二进制消息,按方向和时间查看消息记录。支持子协议、定时心跳、断线自动重连和消息模板,关闭连接时会解释关闭码的含义。
| 关闭码 | 含义 | 常见原因 |
|---|---|---|
| 1000 | 正常关闭 | 任意一方主动关闭 |
| 1001 | 离开 | 服务器重启、浏览器页面关闭或跳转 |
| 1002 | 协议错误 | 帧格式不符合规范 |
| 1003 | 不支持的数据 | 服务器只接受文本却收到了二进制,或者相反 |
| 1006 | 异常断开(无关闭帧) | 网络中断、握手失败、地址错误、证书无效、被代理或防火墙切断,最常见 |
| 1007 | 数据无效 | 文本消息不是合法的 UTF-8 |
| 1008 | 违反策略 | 鉴权失败、来源(Origin)不被允许 |
| 1009 | 消息过大 | 超过服务器允许的单条消息大小 |
| 1011 | 服务器内部错误 | 服务端处理消息时抛出异常 |
| 1012 / 1013 | 服务重启 / 稍后再试 | 服务器维护或过载 |
| 4000~4999 | 应用自定义 | 由具体服务定义,例如 token 过期 |
proxy_http_version 1.1;、proxy_set_header Upgrade $http_upgrade; 和 proxy_set_header Connection "upgrade";,否则握手失败(1006)。调试服务器推送(Server-Sent Events)请用 SSE 在线调试,查看 JSON 消息请用 JSON 格式化校验。
填写 ws:// 或 wss:// 地址(可选填子协议)后点“连接”;在左侧选择文本、JSON 或十六进制二进制,输入或选择模板后按 Ctrl+Enter 发送;右侧显示收发记录,可以筛选、格式化和导出;需要保持连接时开启心跳和自动重连。
填写 wss:// 地址点击连接,连接成功后即可发送和接收消息。
连接异常断开,没有收到关闭帧,常见于网络问题、握手失败或代理配置错误。
浏览器不能自定义请求头,可以把 token 放在网址参数、Cookie 或连接后的第一条消息中。
代理或负载均衡有空闲超时,需要定时发送心跳消息。
浏览器中的 WebSocket 不能自定义请求头,也不能发送协议层的 ping 帧;HTTPS 页面只能连接 wss:// 和本地 ws:// 地址;最多保留最近 3000 条记录。
连接由你的浏览器直接建立,消息不经过本站服务器,发送历史只保存在浏览器本地。
出现 1006 异常断开时,检查地址和端口、证书是否有效、服务器或 Nginx 是否正确配置了 Upgrade 头;鉴权失败通常是 1008 或自定义的 4xxx 关闭码。
GraphQL 调试器 · JSONPath 在线测试 · Nginx 配置生成器 · SSE 在线调试 · 全部开发工具