1. 问题现象与背景分析

最近在调试一个实时数据推送项目时，需要使用Fiddler抓取WebSocket通信数据。按照常规操作流程配置好代理后，却发现Fiddler界面右侧根本没有出现WebSocket按钮。这个问题困扰了我整整两天，期间尝试了各种方法都未能解决。后来通过深入研究Fiddler的工作原理和WebSocket协议特性，终于找到了问题根源和解决方案。

WebSocket作为一种全双工通信协议，在现代Web应用中越来越普及。它建立在单个TCP连接上，通过101状态码完成HTTP协议升级，之后便进入二进制帧传输模式。Fiddler作为中间人代理，需要特殊配置才能正确拦截和解析这种持久化连接。

2. 核心原因排查

2.1 Fiddler版本兼容性问题

首先需要确认使用的是Fiddler Classic而非Fiddler Everywhere。实测发现：

• Fiddler Classic v5.0+ 原生支持WebSocket监控
• Fiddler Everywhere 3.0+ 需要额外插件支持
• 旧版Fiddler 4.x 需要手动启用WebSocket捕获

重要提示：建议使用Fiddler Classic最新版（当前为v5.0.20211.38413），这是最稳定的WebSocket调试版本。

2.2 HTTPS解密配置缺失

WebSocket over HTTPS（wss://）需要先配置证书解密：

1. 打开Fiddler → Tools → Options → HTTPS
2. 勾选"Decrypt HTTPS traffic"
3. 确保"Ignore server certificate errors"已勾选
4. 点击Actions → Trust Root Certificate

# 验证证书是否安装成功 certmgr.msc # 查看"Trusted Root Certification Authorities"中是否存在"DO_NOT_TRUST_FiddlerRoot"

2.3 协议过滤器设置错误

常见错误配置包括：

• 在Filters标签页误开启了"Hide WebSockets"
• Rules → Customize Rules 中设置了WebSocket过滤
• QuickExec命令框输入了"nowebsockets"指令

解决方法：

1. 清除所有过滤器（点击Filters → Remove All）
2. 在QuickExec输入"websockets"回车
3. 重启Fiddler

3. 完整解决方案

3.1 环境准备清单

3.2 分步操作指南

1. 卸载重装Fiddler

   • 完全卸载现有版本
   • 删除%USERPROFILE%\Documents\Fiddler2配置目录
   • 安装时勾选所有组件

2. 配置HTTPS解密

   // 在FiddlerScript中确保有以下配置 if (!oSession.oRequest.headers.Exists("Upgrade") || oSession.oRequest["Upgrade"] != "websocket") { return; }

3. 启用WebSocket捕获

   • 菜单栏：Rules → Customize Rules
   • 搜索OnBeforeRequest方法
   • 添加oSession["x-EnableWebSocket"] = "true";

4. 验证配置

   • 访问WebSocket测试页：wss://echo.websocket.org
   • 右侧应出现WebSocket会话列表
   • 双击会话可查看详细帧数据

4. 高级调试技巧

4.1 二进制消息解析

当遇到二进制数据时：

1. 右键会话 → Save → Entire Session
2. 用Hex编辑器分析原始帧
3. 或使用以下脚本自动解码：

static function OnWebSocketMessage(oMsg: WebSocketMessage) { if(oMsg.IsBinary) { var bytes = oMsg.PayloadAsBytes(); // 自定义解码逻辑... } }

4.2 断点调试方法

在关键节点插入断点：

1. 客户端发送：bpu wss://target.url
2. 服务端响应：bpafter wss://target.url
3. 修改数据后点击"Run to Completion"

4.3 性能监控指标

通过Statistics标签页可获取：

• 往返延迟（RTT）
• 帧大小分布
• 重连次数
• 带宽利用率

5. 常见问题排查手册

6. 实战经验分享

在实际项目中遇到过几个典型场景：

1. SpringBoot应用：需要关闭STOMP心跳干扰

   @Configuration public class WebSocketConfig implements WebSocketMessageBrokerConfigurer { @Override public void configureWebSocketTransport(WebSocketTransportRegistration registration) { registration.setSendTimeLimit(15*1000).setSendBufferSizeLimit(512*1024); } }

2. Koa中间件：注意Node.js的buffer转换

   ws.on('message', (message) => { if (message instanceof Buffer) { message = message.toString('utf8'); } // 处理逻辑... });

3. 移动端调试：Android需要特殊配置

   <!-- AndroidManifest.xml --> <application android:networkSecurityConfig="@xml/network_security_config"> <!-- res/xml/network_security_config.xml --> <network-security-config> <domain-config cleartextTrafficPermitted="true"> <domain includeSubdomains="true">yourdomain.com</domain> </domain-config> </network-security-config>

最后分享一个实用技巧：在长时间监控时，可以使用Ctrl+X清除旧会话，避免内存占用过高导致数据丢失。对于重要会话，建议立即右键保存为SAZ文件备份。