Fiddler字段标红功能在接口调试中的应用与优化

1. Fiddler字段标红功能的应用场景解析

在日常接口调试和网络请求分析中，快速识别关键字段或特定状态是提升工作效率的关键。Fiddler作为老牌抓包工具，其自定义规则功能可以让我们根据字段内容或响应状态实现视觉强化标记。这个功能特别适用于以下场景：

• 接口联调时快速定位错误码（如状态码500、404等）
• 监控特定业务字段变化（如订单状态从"pending"变为"completed"）
• 敏感数据过滤提醒（如包含"password"、"token"等关键字的请求）
• 性能分析时标记慢请求（如响应时间超过2秒的接口）

实际案例：在电商系统测试中，我们经常需要监控订单状态流转。通过配置当response body包含"status":"PAID"时标红显示，可以立即在长长的请求列表中定位到支付成功的订单请求。

2. FiddlerScript基础配置

2.1 启用自定义规则功能

Fiddler的标红功能需要通过FiddlerScript实现。打开Fiddler后：

1. 点击菜单 Rules > Customize Rules
2. 这会打开CustomRules.js文件（默认位于C:\Users[用户名]\Documents\Fiddler2\Scripts）
3. 在代码中找到static function OnBeforeResponse(oSession: Session)函数

2.2 基本标红实现原理

Fiddler的视觉标记主要通过修改Session对象的ui-color属性实现。核心代码如下：

javascript复制if (oSession.oResponse.headers.Exists("Content-Type") && 
    oSession.oResponse.headers["Content-Type"].Contains("application/json")) {
    var body = oSession.GetResponseBodyAsString();
    if (body.Contains("\"error\":true")) {
        oSession["ui-color"] = "red";
    }
}

这段代码会检查响应内容类型为JSON且包含error字段的请求，并将其标记为红色。

3. 多条件标红策略实现

3.1 基于状态码的标记方案

HTTP状态码是最常用的过滤条件之一。以下是常见状态码的标记方案：

javascript复制// 在OnBeforeResponse函数中添加
switch(oSession.responseCode) {
    case 404:
        oSession["ui-color"] = "purple";
        oSession["ui-bold"] = "true";
        break;
    case 500:
        oSession["ui-color"] = "red";
        oSession["ui-customcolumn"] = "服务端错误";
        break;
    case 302:
        oSession["ui-color"] = "orange";
        oSession["ui-backcolor"] = "lightyellow";
        break;
}

3.2 多字段组合判断

实际业务中往往需要更复杂的判断逻辑。例如监控支付接口时：

javascript复制if (oSession.uriContains("/api/payment")) {
    try {
        var json = Fiddler.WebFormats.JSON.JsonDecode(oSession.GetResponseBodyAsString());
        if (json.JSONObject["code"] == 200 && 
            json.JSONObject["data"]["status"] == "FAILED") {
            oSession["ui-color"] = "darkred";
            oSession["ui-backcolor"] = "pink";
            oSession["ui-bold"] = "true";
        }
    } catch(e) {
        // JSON解析异常处理
    }
}

3.3 正则表达式匹配

对于非结构化数据或复杂匹配需求，可以使用正则表达式：

javascript复制var regex = /"amount":\s*(\d+)/;
var match = regex.exec(oSession.GetResponseBodyAsString());
if (match && parseInt(match[1]) > 10000) {
    oSession["ui-color"] = "gold";
    oSession["ui-customcolumn"] = "大额交易";
}

4. 高级定制与优化技巧

4.1 颜色编码体系设计

建议建立统一的颜色编码规范，例如：

4.2 性能优化建议

大量正则匹配可能影响性能，可以添加前置条件判断：

javascript复制// 先检查基本条件再执行复杂匹配
if (oSession.responseCode == 200 && 
    oSession.oResponse.headers.Exists("Content-Type") &&
    oSession.oResponse.headers["Content-Type"].Contains("application/json")) {
    // 执行JSON解析和字段检查
}

4.3 动态规则加载

对于频繁变化的规则，可以外置配置文件：

javascript复制// 加载外部规则文件
var ruleFile = System.IO.File.ReadAllText("C:\\rules.json");
var rules = Fiddler.WebFormats.JSON.JsonDecode(ruleFile).JSONObject;

rules.forEach(function(rule) {
    if (oSession.uriContains(rule.urlPattern)) {
        oSession["ui-color"] = rule.color;
    }
});

5. 常见问题排查指南

5.1 规则不生效的排查步骤

1. 确认脚本已保存（Ctrl+S）且Fiddler已重新加载规则（Rules > Reload Script）
2. 检查语法错误：View > Tabs > Log查看脚本错误
3. 确认匹配条件是否准确：先用Fiddler的Search功能验证能否匹配到目标请求
4. 检查作用域：确保代码放在正确的函数中（OnBeforeResponse/OnBeforeRequest）

5.2 JSON解析异常处理

当响应不是有效JSON时，直接调用JSON解析会报错。应采用防御性编程：

javascript复制try {
    var json = Fiddler.WebFormats.JSON.JsonDecode(oSession.GetResponseBodyAsString());
    // 正常处理逻辑
} catch(e) {
    oSession["ui-customcolumn"] = "JSON解析失败";
}

5.3 特殊字符处理

当字段值包含特殊字符时，直接字符串匹配可能失败。建议：

javascript复制// 不推荐：直接字符串匹配
if (body.Contains("\"name\":\"测试\\\"数据\"")) 

// 推荐：使用JSON解析后判断
if (json.JSONObject["name"] == "测试\"数据")

6. 实际业务场景案例

6.1 电商订单监控实现

以下是完整的电商订单状态监控实现：

javascript复制static function OnBeforeResponse(oSession: Session) {
    if (oSession.uriContains("/order/status") && 
        oSession.oResponse.headers.Exists("Content-Type") &&
        oSession.oResponse.headers["Content-Type"].Contains("application/json")) {
        
        try {
            var json = Fiddler.WebFormats.JSON.JsonDecode(oSession.GetResponseBodyAsString());
            var status = json.JSONObject["data"]["orderStatus"];
            
            switch(status) {
                case "UNPAID":
                    oSession["ui-color"] = "gray";
                    break;
                case "PAID":
                    oSession["ui-color"] = "blue";
                    oSession["ui-bold"] = "true";
                    break;
                case "SHIPPED":
                    oSession["ui-color"] = "green";
                    break;
                case "CANCELLED":
                    oSession["ui-color"] = "red";
                    oSession["ui-strikeout"] = "true";
                    break;
            }
        } catch(e) {
            oSession["ui-backcolor"] = "lightgray";
        }
    }
}

6.2 API性能监控方案

标记响应时间过长的请求：

javascript复制static function OnBeforeResponse(oSession: Session) {
    // 计算响应时间（毫秒）
    var latency = oSession.Timers.ServerDoneResponse - oSession.Timers.ClientBeginRequest;
    
    if (latency > 1000) {  // 超过1秒
        oSession["ui-color"] = "orange";
        oSession["ui-customcolumn"] = "慢请求:" + latency + "ms";
    }
    if (latency > 3000) {  // 超过3秒
        oSession["ui-color"] = "red";
        oSession["ui-bold"] = "true";
    }
}

6.3 敏感信息检测

标记可能包含敏感信息的请求：

javascript复制var sensitiveKeywords = ["password", "token", "creditcard", "ssn"];
sensitiveKeywords.forEach(function(keyword) {
    if (oSession.GetRequestBodyAsString().Contains(keyword) ||
        oSession.GetResponseBodyAsString().Contains(keyword)) {
        oSession["ui-backcolor"] = "pink";
        oSession["ui-customcolumn"] = "敏感信息:" + keyword;
    }
});

7. 扩展功能与进阶技巧

7.1 自定义列显示关键信息

除了颜色标记，还可以在自定义列中显示提取的字段值：

1. 右键点击列标题 > Customize Columns
2. 添加新列，设置Script值为FiddlerScript返回值
3. 在脚本中设置对应值：

javascript复制oSession["ui-customcolumn"] = json.JSONObject["data"]["orderId"];

7.2 结合AutoResponder实现自动拦截

对于特定条件的请求，可以直接返回模拟响应：

javascript复制if (oSession.uriContains("/api/payment") && 
    oSession.GetRequestBodyAsString().Contains("\"amount\":999999")) {
    oSession["ui-color"] = "red";
    oSession["ui-bold"] = "true";
    oSession["x-replywithfile"] = "C:\\mock_response.json";
}

7.3 保存标记会话供后续分析

将重要标记的会话单独保存：

javascript复制if (oSession["ui-color"] == "red") {
    var filename = "Critical_" + oSession.id + ".saz";
    FiddlerApplication.UI.SaveSession(oSession, filename);
}

8. 维护与管理建议

8.1 脚本版本控制

建议将CustomRules.js纳入Git等版本控制系统，特别是团队共享使用时。可以添加文件头注释说明：

javascript复制/*
 * Fiddler标记规则脚本
 * 版本：1.2.0
 * 最后更新：2023-08-20
 * 修改记录：
 * - 新增订单状态标记规则
 * - 优化JSON解析性能
 */

8.2 规则分类管理

当规则较多时，可以按功能模块组织：

javascript复制// 认证相关规则
function applyAuthRules(oSession) {
    // 认证失败标记
}

// 订单相关规则 
function applyOrderRules(oSession) {
    // 订单状态标记
}

// 在主函数中调用
static function OnBeforeResponse(oSession: Session) {
    applyAuthRules(oSession);
    applyOrderRules(oSession);
}

8.3 团队共享方案

对于团队使用，可以考虑：

1. 将公共规则放在共享网络位置
2. 使用脚本自动同步最新规则：

javascript复制// 启动时加载共享规则
static function OnAttach() {
    var sharedRules = System.IO.File.ReadAllText("\\server\share\fiddler_rules.js");
    eval(sharedRules);
}