WebSocket测试工具 - 在线WebSocket连接调试工具

终端式消息日志、毫秒级收发时序、文本/JSON/二进制/HEX 四种格式收发、自动心跳与断线重连——把调试 WebSocket 的常用动作放在一个页面,纯前端实现,数据不出浏览器。

未连接

暂无消息

在上方填入 WebSocket 地址连接后,收发记录会以终端风格列在这里

显示 0 / 共 0 条

发送消息

心跳

自动心跳(发文本 ping)

连接

尚未建立连接。断开后统计会保留,方便回看上一次连接的收发情况。

# 什么是 WebSocket?

WebSocket 是一种在单个TCP连接上进行全双工通信的协议。WebSocket使得客户端和服务器之间的数据交换变得更加简单, 允许服务端主动向客户端推送数据。在WebSocket API中,浏览器和服务器只需要完成一次握手, 两者之间就直接可以创建持久性的连接,并进行双向数据传输。

相较于传统的HTTP轮询方式,WebSocket具有更低的延迟和更高的效率,特别适合需要实时通信的应用场景, 如在线聊天、实时数据推送、股票行情、在线游戏等。使用WebSocket测试工具可以帮助开发者快速验证WebSocket服务器的功能, 调试通信问题,确保应用的稳定性和可靠性。

# 如何用本工具调试 WebSocket

  1. 在顶部命令栏输入服务器地址(支持 ws:// 与 wss://),可从 URL 历史里直接选以前测过的端点
  2. 需要子协议的填子协议,点击「连接」,状态点变绿即握手成功
  3. 右侧发送区切换格式:文本、JSON(发送前校验语法)、二进制(按 UTF-8 编码)、HEX(如 48 65 6c,调试二进制协议)
  4. 日志区按毫秒时间戳列出每条收发,点击任意一行展开 JSON 美化或二进制 hex+ASCII 预览
  5. 用方向 Tab(发送/接收/系统/错误)和搜索框过滤日志;hover 消息行可复制或按原格式重发
  6. 长连接测试打开自动心跳与自动重连;断开连接后统计卡保留收发字节数供回看

# 核心功能特性

  • 终端式日志:毫秒时间戳 + 收发间隔 + 字节数,单行一条,方向 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服务器一目了然

本地

相关教程