Whistle 踩坑：\`\* disable://capture\` 导致请求头丢失、下游网关无法接收环境路由参数

一、问题现象
在使用 Whistle 做网络代理调试时，若全局配置规则：

• disable://capture
  会出现以下典型异常现象：

1. 控制台异常：Whistle Network 面板请求状态为 captureError，无完整请求详情、无法查看请求体与响应体；
2. 域名展示异常：请求 Host 栏显示为 Tunnel to，而非具体业务域名；
3. 业务功能异常：客户端请求携带的环境路由类自定义 reqHeaders 无法透传至下游网关，网关接收不到环境标识、路由分区等关键请求头，导致路由匹配失败、接口转发异常、环境调用错乱等问题。
   二、问题根因
   核心原因是disable://capture 规则会关闭 Whistle 的 HTTPS 流量捕获、解密与篡改能力，彻底改变代理转发逻辑：
4. 常规开启捕获（默认 enable://capture）时，Whistle 会通过中间人解密（MITM）解析 HTTPS 请求，完整读取、透传客户端的 reqHeaders，同时支持修改、拦截、日志记录；
5. 配置 disable://capture 后，Whistle 不再解密 HTTPS 隧道流量，仅做原始 TCP 隧道转发，不会解析请求报文头部信息；
6. 此时请求直接以CONNECT 隧道模式 透传，Whistle 无法提取、保留及转发自定义请求头，所有依赖请求头传递的环境路由、身份标识、灰度参数等数据都会丢失，下游网关无法获取对应路由信息。
   三、关键原理说明
7. disable://capture 作用机制
   disable://capture 是 Whistle 核心流量控制规则，作用是禁用指定域名/全量域名的 HTTPS 捕获与解析能力。配置全局 * disable://capture 后，所有 HTTPS 请求都会跳过解密、解析、脚本处理、头信息修改等所有上层代理逻辑，仅保留最基础的隧道直通能力，目的是规避部分 SSL 证书校验问题、提升代理转发性能，但会牺牲请求报文的解析与透传能力。
8. Tunnel to 与 captureError 含义
   Network 面板出现 Tunnel to + captureError 是HTTPS 隧道未捕获的标志性特征：

• Tunnel to：代表当前请求为纯 TCP 隧道转发，Whistle 未解析到具体业务域名，仅建立客户端与服务端的直通通道；
• captureError：并非真正的网络报错，而是 Whistle 提示「当前流量已关闭捕获能力，无法解析请求详情」，属于规则配置导致的正常状态反馈，而非请求失败。

3. 为什么环境路由头会丢失？
   环境路由、灰度环境、服务分区等自定义 Header，属于HTTPS 应用层报文数据，必须在流量解密、报文解析后才能被代理识别并透传。而 disable://capture 直接跳过应用层解析，仅传输加密原始流量，代理无法感知任何请求头、请求体信息，最终下游网关接收的请求为「无自定义头部的原始隧道请求」，路由匹配逻辑失效。
   四、解决方案
   方案一：移除全局禁用规则（推荐，适配绝大多数调试场景）
   直接删除 Rules 中全局配置的 * disable://capture，恢复 Whistle 默认的流量捕获能力：

删除该行全局规则

* disable://capture

保存规则后刷新请求，即可正常解析、透传所有 reqHeaders，下游网关可正常获取环境路由信息，Network 面板恢复正常域名展示，captureError 报错消失。
方案二：精准限定禁用范围，保留业务域名捕获能力
若部分第三方域名需要关闭捕获（规避证书报错、抓包冲突），禁止全局禁用，采用精准域名匹配配置，仅对非业务域名关闭捕获，核心业务域名开启捕获：

仅对第三方域名禁用捕获

*.third-party.com disable://capture

核心业务域名强制开启捕获（保证请求头正常透传）

*.biz-domain.com enable://capture

方案三：全局开启捕获，按需规避证书问题
如果担心全局捕获出现 SSL 证书报错，不要关闭捕获，而是通过 Whistle 证书配置、忽略证书错误等方式兼容，同时保证请求头正常透传：

1. 安装并信任 Whistle 根证书，开启 HTTPS 全局捕获；
2. 针对特殊域名，单独配置证书忽略规则，不影响全局报文解析。
   五、避坑总结
3. 禁止随意配置全局 * disable://capture：该规则会全量禁用 HTTPS 报文解析，所有自定义请求头、请求参数、响应数据都会丢失，彻底丧失代理调试能力；
4. Tunnel to + captureError 快速定位：看到该现象优先排查是否存在禁用捕获的规则，而非证书、网络问题；
5. 路由/灰度/环境参数调试必备：所有依赖请求头透传的业务场景，必须保证业务域名开启 enable://capture；
6. 规则最小权限原则：禁用捕获仅针对个别异常域名，不做全局禁用，兼顾稳定性与调试能力。