4. 熔断器参数配置：滑动窗口、阈值与超时

熔断器的核心价值在于通过统计窗口内的调用数据，自动判断服务是否处于“亚健康”或“故障”状态，并执行切断/恢复动作。参数配置直接决定了熔断的灵敏度和稳定性。本节围绕四个关键参数展开：滑动窗口大小、请求阈值、错误百分比阈值、熔断超时时间。

4.1 参数全景与作用

4.2 滑动窗口：统计的时间切片

滑动窗口将时间划分为多个桶（Bucket），每个桶记录该时间片内的请求总数和错误数。窗口随时间向前滑动，丢弃最旧的桶，加入最新的桶。常见的实现方式有两种：

• 基于时间片的滑动窗口：固定桶数（如 10 个桶，每个桶 1s），窗口总长度 = 桶数 × 桶时长。
• 基于请求数的滑动窗口：固定记录最近 N 次请求的成败状态，不依赖时间。

下图展示了一个 10 秒滑动窗口（10 个桶，每桶 1 秒）的统计过程：

4.3 请求阈值：避免冷启动误判

请求阈值（requestVolumeThreshold）定义了触发熔断判断的最低请求量。当窗口内总请求数低于此值时，即使错误率很高，熔断器也不会打开。这是为了防止在服务刚启动或流量极低时，因少量偶然错误就熔断。

4.4 错误百分比阈值：熔断的触发线

当窗口内请求数 ≥ 请求阈值时，计算错误百分比：

错误百分比 = (窗口内错误请求数 / 窗口内总请求数) × 100%

若错误百分比 ≥ 配置的阈值（如 50%），熔断器从 CLOSED 状态切换到 OPEN 状态，后续请求直接快速失败。

4.5 熔断超时时间：恢复试探的间隔

熔断超时时间（circuitBreakerTimeout）决定了熔断器在 OPEN 状态停留多久后，尝试进入 HALF_OPEN 状态。超时时间过短会导致频繁试探，过长则延长服务不可用时间。

下图展示了熔断器状态机与超时时间的关系：

4.6 参数配置示例（Hystrix / Sentinel 风格）

以下是一个基于 Hystrix 命令的典型配置，展示四个参数的实际赋值：

// HystrixCommand 配置示例
HystrixCommandProperties.Setter()
    // 滑动窗口大小：10 秒
    .withMetricsRollingStatisticalWindowInMilliseconds(10_000)
    // 窗口内桶数：10 个（每桶 1 秒）
    .withMetricsRollingStatisticalWindowBuckets(10)
    // 请求阈值：最少 20 次请求才触发熔断判断
    .withCircuitBreakerRequestVolumeThreshold(20)
    // 错误百分比阈值：50%
    .withCircuitBreakerErrorThresholdPercentage(50)
    // 熔断超时时间：15 秒
    .withCircuitBreakerSleepWindowInMilliseconds(15_000);

4.7 参数调优建议

• 滑动窗口大小：建议设置为服务平均响应时间的 5~10 倍。例如平均响应 200ms，窗口设为 1~2s；若平均响应 2s，窗口设为 10~20s。
• 请求阈值：根据服务正常流量设定。若服务每分钟 600 次请求（每秒 10 次），窗口 10s 内约 100 次请求，阈值可设为 20~30。
• 错误百分比阈值：核心服务建议 40%~50%，非核心服务可放宽至 60%~70%。
• 熔断超时时间：建议等于或略大于服务平均恢复时间。可通过健康检查接口的响应时间估算。