WebSocket测试工具 - 在线WebSocket连接调试工具
终端式消息日志、毫秒级收发时序、文本/JSON/二进制/HEX 四种格式收发、自动心跳与断线重连——把调试 WebSocket 的常用动作放在一个页面,纯前端实现,数据不出浏览器。
暂无消息
在上方填入 WebSocket 地址连接后,收发记录会以终端风格列在这里
发送消息
心跳
连接
尚未建立连接。断开后统计会保留,方便回看上一次连接的收发情况。
# 什么是 WebSocket?
WebSocket 是一种在单个TCP连接上进行全双工通信的协议。WebSocket使得客户端和服务器之间的数据交换变得更加简单, 允许服务端主动向客户端推送数据。在WebSocket API中,浏览器和服务器只需要完成一次握手, 两者之间就直接可以创建持久性的连接,并进行双向数据传输。
相较于传统的HTTP轮询方式,WebSocket具有更低的延迟和更高的效率,特别适合需要实时通信的应用场景, 如在线聊天、实时数据推送、股票行情、在线游戏等。使用WebSocket测试工具可以帮助开发者快速验证WebSocket服务器的功能, 调试通信问题,确保应用的稳定性和可靠性。
# 如何用本工具调试 WebSocket
- 在顶部命令栏输入服务器地址(支持 ws:// 与 wss://),可从 URL 历史里直接选以前测过的端点
- 需要子协议的填子协议,点击「连接」,状态点变绿即握手成功
- 右侧发送区切换格式:文本、JSON(发送前校验语法)、二进制(按 UTF-8 编码)、HEX(如 48 65 6c,调试二进制协议)
- 日志区按毫秒时间戳列出每条收发,点击任意一行展开 JSON 美化或二进制 hex+ASCII 预览
- 用方向 Tab(发送/接收/系统/错误)和搜索框过滤日志;hover 消息行可复制或按原格式重发
- 长连接测试打开自动心跳与自动重连;断开连接后统计卡保留收发字节数供回看
# 核心功能特性
- 终端式日志:毫秒时间戳 + 收发间隔 + 字节数,单行一条,方向 Tab 过滤、内容搜索、一键导出 JSON
- 四种发送格式:文本 / JSON(语法校验)/ 二进制(UTF-8 字节)/ HEX(十六进制字节流)
- 二进制可视化:收到的二进制帧按 hex + ASCII 分栏预览(前 256 字节),不再只显示"二进制数据"
- 一键重发:hover 任意收发记录按原格式重发,配合 payload 历史回填,改一个字就能再测
- 自动心跳与重连:按自定义间隔发 ping 保活;异常断线 3 秒后自动重连(最多 5 次)
- 关闭码释义:断开时把 1006、1015 这类数字代码翻译成人话,快速定位是网络、证书还是服务端问题
- 连接统计保留:断开后仍可回看上次连接的时长与收发字节数
- 纯本地实现:连接与数据都在浏览器内完成,不做任何服务端转发
# WebSocket 关闭码含义对照
连接断开时浏览器会给出 close code,对照下表可以快速判断断开原因:
1000 — 正常关闭(双方协商一致)
1001 — 端点离开(页面关闭或服务器下线)
1002 — 协议错误(帧格式不符合 WebSocket 规范)
1003 — 收到了端点无法处理的数据类型
1006 — 异常关闭:网络中断、代理断连或握手未完成,最常见的"莫名掉线"就是它
1008 — 策略原因被拒(鉴权失败、Token 过期、来源不在白名单)
1009 — 单条消息超出服务器限制
1011 — 服务器内部错误
1015 — TLS 握手失败(wss:// 证书无效或被中间设备拦截)
# 常见问题 (FAQ)
WebSocket 和 HTTP 轮询有什么区别?
WebSocket是全双工通信协议,客户端和服务器可以同时发送数据,而HTTP轮询需要客户端不断发起请求。 WebSocket连接建立后可以持久保持,减少了握手开销,延迟更低,效率更高。 对于需要频繁通信的应用,WebSocket是更好的选择。
为什么 WebSocket 连接失败?
可能的原因包括:URL格式错误、服务器不支持WebSocket、防火墙阻止连接、SSL证书问题(对于wss://)。 本工具会在关闭码释义里给出断开原因提示:1015 优先查证书链,1006 优先查网络与代理,1008 优先查鉴权与来源限制。
怎么测试本机的 WebSocket 服务?
本地起的服务直接填 ws://127.0.0.1:端口 即可(本页面就是浏览器环境,访问本机回环地址没有跨域限制—— WebSocket 握手遵循同源策略但服务端通常不校验 Origin 时可直连;若服务端校验 Origin,请把允许来源加上本页域名)。 示例下拉里内置了本地回环端点,方便从命令行起一个 echo 服务后快速联调。
WebSocket 支持哪些消息类型?
协议层面只有文本帧和二进制帧两种。文本帧可以放任何 UTF-8 字符串(JSON 是其上的约定), 二进制帧可以承载图片、Protocol Buffers、自定义协议等任意字节。 本工具的发送区把这两种帧拆成了文本 / JSON / 二进制 / HEX 四个入口,接收日志会对每一帧自动识别格式并给出对应预览。
相关工具推荐
网络速度测试
测量网络下载上传速度、延迟与抖动,多节点对照让带宽状况心中有数
手机号归属地查询
内置号段库本地查询运营商与归属地,最长前缀匹配,携号转网口径与批量脱敏
CORS测试工具
检测接口CORS跨域配置,预检请求模拟与响应头分析,附服务端配置代码生成
WebRTC诊断工具
WebRTC连接测试、ICE候选收集、媒体设备检测
IP信息查询
查询IP地址的归属地、运营商与ASN信息,支持IPv4与IPv6,定位结果清晰呈现
WHOIS查询
查询域名WHOIS注册信息,注册商、到期时间与DNS服务器一目了然
相关教程
测速、DNSSEC、子网划分:16 件网络诊断工具清单
用户说网页打不开、改了解析半天不生效、划子网借位借到头晕——网络问题难在定位。这篇把站点 16 件网络诊断工具分成连通与测速、DNS 与解析、地址与规划、配套四组,按排查顺序对号入座。
2026-11-08
网络排查工具箱:从 ping 到 TLS 的 30 款浏览器工具
网站打不开、接口报跨域、证书快过期——网络问题层层有对应工具。站内网络工具箱已有三十余款,这篇挑 24 款串成完整排查链:WHOIS 与 DNS 查域名,路由追踪与测速看路径,子网和 IPv6 管规划,HTTP 客户端、cURL 转码、状态码表调接口,SSL 检查与 DNSSEC 守 TLS 这一环。解析与生成类全部在浏览器本地完成,敏感配置不出本机。
2026-10-20