Apifox中WebSocket连接必须严格使用ws://或wss://开头，漏写斜杠、混用http://或环境与协议不匹配均导致连接失败；鉴权需通过Headers或Query参数配置，且wss抓包须启用Charles SSL Proxying并安装根证书。
Apifox里填错ws://和wss://地址会直接连接失败
Apifox不接受任何变体写法，ws:// 和 wss:// 必须严格出现在URL开头，且后面紧接域名或localhost。常见错误包括：
- 漏掉冒号斜杠，比如写成
ws//localhost:8080→ 报错“协议不支持” - 混用HTTP前缀，比如
http://localhost:8080/ws→ 界面无反应，也不提示错误 - 生产环境用了
ws://但服务端只监听wss://→ 显示“握手失败”，实际是TLS层被拒绝
本地调试建议统一用ws://localhost:端口/路径；上线前必须切换为wss://，并确认后端已配置有效证书。
在Apifox中加Header或Query参数才能通过鉴权
很多WebSocket服务要求token、session或自定义协议头，Apifox提供两个入口设置：
-
Headers面板：适合放
Authorization、Sec-WebSocket-Protocol等标准头 -
Query参数栏：适合传
token=abc123、user_id=1001这类轻量认证信息
注意：Sec-WebSocket-Version: 13通常不用手动加，Apifox默认发送；但如果服务端老版本只认13而你连不上，可显式添加。另外，Cookie不会自动携带，需手动填入Headers里的Cookie字段。
Apifox（Linux）
下载
Apifox Linux 桌面版是一款专为 Linux 开发者打造的 API 一体化工具，集接口设计、调试、测试、Mock 和文档管理于一体。它在 Linux 环境下提供稳定、高效的本地运行体验，帮助开发者实现 API 全生命周期管理，是 Linux 开发者进行接口开发与联调的高效工具。
Charles抓WebSocket必须配SSL Proxying才能解密wss流量
抓wss://流量时，Charles不是“打开就能看”，关键步骤缺一不可：
- 在
Proxy → SSL Proxying Settings中启用代理，并添加目标域名+端口（如*.api.example.com:443） - 手机或浏览器需安装Charles根证书，否则看到的是加密的TLS记录，不是WebSocket帧
- 抓包列表里要切换到
WebSocket标签页，而非Structure或Sequence，否则看不到Ping/Pong帧和文本/二进制消息分隔
没配SSL Proxying就去抓wss，只会看到一堆TLS record，根本没法分析业务数据。
Apifox收发消息时容易忽略编码和帧类型差异
Apifox默认以UTF-8文本方式发送，但服务端可能期待二进制帧（比如图片、protobuf序列化数据）。现象是：连接正常、发送无报错，但服务端收不到或解析失败。
- 发送前确认消息格式：JSON字符串选
Text；字节流（如Base64解码后）选Binary - Apifox不自动处理
ArrayBuffer或Uint8Array，需提前转成Base64再粘贴到Binary输入框 - 收到
Binary消息时，Apifox默认显示十六进制，点右上角UTF-8可尝试解码——但若服务端发的是压缩或加密二进制，这里只会显示乱码
真正难的不是连上，而是让每一帧的opcode、mask、payload都对得上服务端预期。这点在Apifox界面里完全不可见，只能靠服务端日志或Charles帧详情反推。
