📚 课程目录第4章熔断核心指标

4. 熔断核心指标：错误率阈值、慢调用阈值、半开状态探测、滑动窗口与统计周期

催收API的熔断机制并非简单的开关，而是由一组精密协同的核心指标与算法构成。本章将逐一拆解这些指标的定义、计算方式及配置策略，帮助你在“保护系统”与“最大化催收产能”之间找到最佳平衡点。

4.1 错误率阈值（Error Rate Threshold）

错误率阈值是熔断器最直接的触发条件。当调用第三方催收渠道（如外呼、短信、AI语音）的失败比例超过设定值时，熔断器打开，停止对该渠道的后续请求。

定义：在统计周期内，失败请求数 / 总请求数 × 100%。
失败类型：HTTP 5xx、连接超时、渠道返回的业务错误码（如余额不足、号码屏蔽）、响应体解析异常。
典型配置：生产环境通常设置为 50% ~ 80%，高可用场景可收紧至 30%。

场景	推荐阈值	说明
核心催收渠道（如银行直连）	30%	容忍度低，优先保障成功率
普通短信/语音渠道	60%	允许一定波动，避免频繁熔断
实验性/备用渠道	80%	容忍度高，主要用于兜底

实践建议：不要将错误率阈值设得过低（如 10%），否则网络抖动或单次批量失败会引发不必要的熔断，导致催收任务积压。

4.2 慢调用阈值（Slow Call Threshold）

慢调用阈值用于识别响应过慢的渠道。即使请求最终成功，如果耗时超过阈值，也会被计入“慢调用”计数，累积到一定比例后触发熔断。

定义：单次请求耗时超过设定值（如 3000ms）即视为慢调用。
统计方式：在滑动窗口内，慢调用数 / 总请求数 ≥ 慢调用比例阈值（如 40%）。
与错误率的区别：错误率关注“是否成功”，慢调用关注“是否及时”。

  关键参数示例：

  慢调用阈值 = 2000ms

  慢调用比例阈值 = 50%

  含义：若在统计周期内，超过一半的请求耗时大于 2 秒，则触发熔断。

4.3 半开状态探测（Half-Open Probe）

熔断器打开后，系统不会永久切断渠道。经过设定的等待时间（如 30 秒），熔断器进入“半开状态”，允许少量探测请求通过，以验证渠道是否恢复。

探测请求数：通常设置为 1 ~ 5 个。
判定逻辑：若探测请求全部成功，熔断器关闭，恢复正常流量；若任意一个失败，熔断器重新打开，并重置等待时间。
重要性：防止渠道恢复后长时间被冷落，造成资源浪费。

4.4 滑动窗口与统计周期（Sliding Window & Statistics Period）

熔断指标的计算依赖于时间窗口。滑动窗口比固定窗口更能反映实时状态，避免“毛刺”或“边界效应”。

固定窗口：每 10 秒统计一次，窗口切换瞬间可能丢失数据或产生误判。
滑动窗口：将时间窗口细分为多个桶（如 10 个 1 秒桶），每过 1 秒滑动一次，保留最近 10 秒的完整数据。
统计周期：通常设置为 10 ~ 60 秒，周期越短，熔断响应越快，但误触概率也越高。

特性	固定窗口	滑动窗口
数据精度	低（边界处可能突变）	高（连续平滑）
内存开销	低（仅存一个计数）	中（需维护多个桶）
适用场景	非关键、低并发渠道	核心催收、高并发渠道
误判风险	较高	较低

4.5 指标联动与配置示例

上述四个指标并非孤立存在，而是协同工作。以下是一个生产级的熔断配置示例：

# 催收渠道熔断配置（YAML 示例）
channel:
  name: "sms_provider_a"
  circuit_breaker:
    enabled: true
    # 滑动窗口大小（秒）
    sliding_window_size: 10
    # 桶数量（每个桶 1 秒）
    bucket_count: 10
    # 最小请求数（避免样本不足时误判）
    minimum_requests: 5
    # 错误率阈值（百分比）
    error_rate_threshold: 60
    # 慢调用阈值（毫秒）
    slow_call_threshold_ms: 3000
    # 慢调用比例阈值（百分比）
    slow_call_ratio_threshold: 50
    # 半开状态等待时间（秒）
    half_open_wait_seconds: 30
    # 半开状态探测请求数
    half_open_probe_count: 3

避坑提醒：
1. 不要忽略 minimum_requests（最小请求数）。在低流量时段，少量失败可能触发熔断，导致渠道被误杀。
2. 半开状态的探测请求应使用与正常请求相同的超时和重试策略，避免探测结果失真。
3. 滑动窗口的桶数量不宜过多（建议 10 ~ 20 个），否则内存开销和计算延迟会上升。

4.6 指标选择决策树

在实际配置中，可根据渠道特性选择重点关注的指标：

高并发渠道（如批量短信）：优先关注错误率阈值 + 滑动窗口，快速熔断。
低延迟渠道（如实时外呼）：优先关注慢调用阈值，避免长时间等待阻塞线程。
备用/降级渠道：放宽所有阈值，但缩短半开等待时间，尽快恢复使用。
新接入渠道：先设置较宽松的阈值，收集基线数据后再逐步收紧。

掌握这些核心指标，你就能为催收系统构建一套“智能、自愈、可控”的熔断机制，确保在任何渠道波动下，催收任务都能稳定推进。