PHPLEFT程序开发
WEBSOCKET TEST

WebSocket 在线测试

浏览器本地 WebSocket 在线测试,支持多 Query 参数、子协议、心跳、自动重连,以及文本/JSON/Hex/Base64 发送与消息日志。

浏览器直连目标服务,站点不中转流量
未连接 请输入 WebSocket 地址

Query 参数

发送消息

消息日志

支持 ws/wss 地址与多个 Query 参数拼接

可配置子协议、心跳包与自动重连

发送支持文本、JSON、Hex、Base64

完整消息日志,区分发送、接收与系统事件

WebSocket 在线测试怎么用?

填写 ws/wss 地址后可添加多个 Query 参数与子协议,连接成功即可发送文本、JSON、Hex 或 Base64 数据。需要保活时可启用心跳;断线后可按设定间隔自动重连。消息日志会记录发送、接收与系统事件,方便接口联调与问题排查。连接由当前浏览器直接发起,站点不会代理或保存通信内容。

WebSocket 基本介绍

WebSocket 是一种在单个 TCP 连接上实现全双工通信的协议,适合聊天、行情推送、协作编辑、设备监控等需要服务端主动推送的场景。与传统 HTTP 一问一答不同,连接建立后双方可随时收发消息,延迟更低、开销更小。

  • 协议前缀:开发环境常用 ws://,生产环境建议 wss://(基于 TLS 加密)。
  • 握手过程:先通过 HTTP Upgrade 升级为 WebSocket,再进入帧消息通信。
  • 消息类型:常见为文本帧与二进制帧;业务层可自行约定 JSON、Protobuf 等格式。
  • 子协议:可通过 Sec-WebSocket-Protocol 协商应用层协议,如特定业务通道名。
  • 保活:长时间无业务流量时,可用应用层心跳或底层 Ping/Pong 维持连接。

WebSocket 常见问题

ws 和 wss 有什么区别?

ws:// 为明文传输,适合本地或内网调试;wss:// 走 TLS 加密,可避免中间人窃听,也是 HTTPS 页面上通常唯一可用的方案(混合内容限制)。线上服务请优先使用 wss。

为什么连接失败或马上断开?

常见原因:地址写错、服务未启动、防火墙拦截、证书无效、要求特定子协议、鉴权 Query/Token 缺失,或服务端主动拒绝握手。可对照浏览器控制台与本页日志中的关闭码、原因文案排查。

HTTPS 页面能连 ws:// 吗?

一般不行。浏览器会把「HTTPS 页面访问明文 ws」视为不安全的混合内容并拦截。请改用 wss://,或在本地 HTTP 页面调试 ws://。

子协议(Protocol)什么时候填?

仅当服务端明确要求协商子协议时才填写,例如某些网关或业务通道名。填错或未协商成功时,握手可能直接失败;不需要时可留空。

心跳有什么用?怎么设置?

心跳用于在无业务消息时保持连接活跃,避免被代理、负载均衡或服务端空闲超时踢下线。可按服务约定发送文本/JSON 心跳内容,并设定合理间隔(过短会增加流量,过长可能仍被超时断开)。

自动重连会一直重试吗?

开启后,断线会按设定间隔尝试重连,便于弱网或服务短暂重启场景。若地址错误或鉴权失败,应关闭自动重连,先修正配置,避免无意义刷连接。

消息可以发 JSON / Hex / Base64 吗?

可以。文本与 JSON 按字符串发送;Hex、Base64 适合调试二进制协议。注意服务端实际约定的编码,发错格式会导致对端无法解析。

流量会经过本站服务器吗?

不会。本工具由浏览器直接连接目标 WebSocket 服务,站点不中转、不保存通信内容。因此目标服务需允许你当前浏览器所在网络访问,并正确处理跨域/Origin 策略(若服务端有校验)。

和 HTTP 接口测试有什么不同?

HTTP 偏请求-响应、无状态;WebSocket 是长连接双向通道。调试 REST/API 用 HTTP 工具更合适;需要推送、订阅、实时互动时用 WebSocket 工具。