WebSocket 在线测试

连接 ws:// 或 wss:// 地址,发送文本、JSON 或二进制消息,按方向和时间查看消息记录。支持子协议、定时心跳、断线自动重连和消息模板,关闭连接时会解释关闭码的含义。

未连接
秒发送
消息记录

常见关闭码

关闭码含义常见原因
1000正常关闭任意一方主动关闭
1001离开服务器重启、浏览器页面关闭或跳转
1002协议错误帧格式不符合规范
1003不支持的数据服务器只接受文本却收到了二进制,或者相反
1006异常断开(无关闭帧)网络中断、握手失败、地址错误、证书无效、被代理或防火墙切断,最常见
1007数据无效文本消息不是合法的 UTF-8
1008违反策略鉴权失败、来源(Origin)不被允许
1009消息过大超过服务器允许的单条消息大小
1011服务器内部错误服务端处理消息时抛出异常
1012 / 1013服务重启 / 稍后再试服务器维护或过载
4000~4999应用自定义由具体服务定义,例如 token 过期
  • wss 和 ws:HTTPS 页面(包括本页面)只能连接 wss:// 地址,连接 ws:// 会被浏览器拦截,本地开发的 ws://localhost 除外。
  • 浏览器的限制:网页中的 WebSocket 不能自定义请求头(无法携带 Authorization),鉴权通常通过网址参数(如 ?token=)、Cookie 或连接后发送的第一条消息完成;子协议(Sec-WebSocket-Protocol)有时也被用来传递 token。
  • 心跳:Nginx 默认 60 秒没有数据会断开代理的连接(proxy_read_timeout),云负载均衡也有类似的空闲超时,客户端或服务端需要定时发送心跳。浏览器无法发送协议层的 ping 帧,只能发送应用层的心跳消息。
  • 反向代理:Nginx 代理 WebSocket 需要设置 proxy_http_version 1.1;、proxy_set_header Upgrade $http_upgrade; 和 proxy_set_header Connection "upgrade";,否则握手失败(1006)。

调试服务器推送(Server-Sent Events)请用 SSE 在线调试,查看 JSON 消息请用 JSON 格式化校验。

WebSocket 在线测试常见问题

WebSocket 在线测试怎么使用?

填写 ws:// 或 wss:// 地址(可选填子协议)后点“连接”;在左侧选择文本、JSON 或十六进制二进制,输入或选择模板后按 Ctrl+Enter 发送;右侧显示收发记录,可以筛选、格式化和导出;需要保持连接时开启心跳和自动重连。

怎么在线测试 WebSocket?

填写 wss:// 地址点击连接,连接成功后即可发送和接收消息。

WebSocket 关闭码 1006 是什么意思?

连接异常断开,没有收到关闭帧,常见于网络问题、握手失败或代理配置错误。

WebSocket 能带 token 吗?

浏览器不能自定义请求头,可以把 token 放在网址参数、Cookie 或连接后的第一条消息中。

为什么连接一段时间后自动断开?

代理或负载均衡有空闲超时,需要定时发送心跳消息。

WebSocket 在线测试的结果应怎样理解?

浏览器中的 WebSocket 不能自定义请求头,也不能发送协议层的 ping 帧;HTTPS 页面只能连接 wss:// 和本地 ws:// 地址;最多保留最近 3000 条记录。

输入内容会保存或发给外部服务吗?

连接由你的浏览器直接建立,消息不经过本站服务器,发送历史只保存在浏览器本地。

没有结果或操作失败时先检查什么?

出现 1006 异常断开时,检查地址和端口、证书是否有效、服务器或 Nginx 是否正确配置了 Upgrade 头;鉴权失败通常是 1008 或自定义的 4xxx 关闭码。

相关工具

GraphQL 调试器 · JSONPath 在线测试 · Nginx 配置生成器 · SSE 在线调试 · 全部开发工具