4. 核心参数详解（上）：滑动窗口大小、请求数阈值、错误百分比阈值
熔断器的核心参数决定了“何时触发熔断”以及“熔断后如何恢复”。本章聚焦三个最关键的参数：滑动窗口大小、请求数阈值和错误百分比阈值。这三个参数共同构成了熔断器的决策基础，理解它们的交互关系是校准多环境模板的前提。
4.1 滑动窗口大小（Sliding Window Size）
滑动窗口是熔断器收集调用指标的时间范围。它决定了熔断器“看多远的历史数据”来做决策。常见的实现方式有两种：基于时间窗口（如 10 秒）和基于请求计数窗口（如 100 次请求）。
核心原则：窗口越大，统计越平滑，但对突发故障的响应越慢；窗口越小，响应越快，但容易受瞬时抖动影响。
4.1.1 滑动窗口的工作机制
滑动窗口被划分为多个桶（Bucket），每个桶记录一个时间片内的请求总数、成功数、失败数等指标。窗口随时间向前滑动，新桶加入，旧桶丢弃。
4.1.2 窗口大小选择建议
| 场景 | 推荐窗口大小 | 桶数量 | 理由 |
|---|---|---|---|
| 高并发核心服务 | 10 秒 | 10 个（每桶 1 秒） | 秒级粒度，快速感知故障 |
| 低流量批处理服务 | 60 秒 | 12 个（每桶 5 秒） | 需要足够样本量，避免误判 |
| 数据库连接池 | 30 秒 | 6 个（每桶 5 秒） | 平衡响应速度与稳定性 |
| 外部 API 调用 | 20 秒 | 10 个（每桶 2 秒） | 兼顾网络抖动容忍与快速熔断 |
常见陷阱：窗口大小设置过大（如 300 秒）会导致熔断器对故障“后知后觉”，在故障发生后的几分钟内仍可能放行大量请求，造成级联雪崩。窗口大小设置过小（如 1 秒）则容易因单次超时或网络抖动而误触发熔断。
4.2 请求数阈值（Request Volume Threshold）
请求数阈值定义了在滑动窗口内至少需要多少请求，熔断器才会开始计算错误百分比。如果窗口内的请求总数低于此阈值，即使所有请求都失败，熔断器也不会触发熔断。
4.2.1 为什么需要请求数阈值？
在低流量场景下，少量请求的失败可能不代表系统真实状态。例如：
- 窗口内只有 1 个请求且失败 → 错误率 100%，但样本不足，不应熔断。
- 窗口内有 100 个请求且 51 个失败 → 错误率 51%，样本充足，应触发熔断。
请求数阈值就是用来过滤掉“统计噪声”的。
4.2.2 阈值设置策略
| 流量模式 | 推荐阈值 | 说明 |
|---|---|---|
| 高并发（>1000 QPS） | 100 | 快速积累样本，阈值可设高，避免过早熔断 |
| 中等流量（100-1000 QPS） | 20-50 | 平衡样本量与响应速度 |
| 低流量（<10 QPS） | 5-10 | 阈值设低，否则窗口内永远达不到统计要求 |
| 定时任务/批处理 | 3-5 | 请求稀疏，阈值必须很低才能生效 |
校准技巧：在生产环境中，先观察一周的请求量分布，取 P25（第 25 百分位）的请求数作为阈值下限。例如，如果 75% 的时间窗口内请求数都超过 30，则阈值可设为 30。
4.3 错误百分比阈值（Error Percentage Threshold）
当窗口内的请求总数达到请求数阈值后，熔断器开始计算错误百分比。如果错误百分比超过此阈值，熔断器将打开（Open），后续请求直接快速失败。
4.3.1 错误百分比的计算方式
错误百分比 = （失败请求数 / 总请求数）× 100%。不同类型的失败应被正确归类：
- 超时（Timeout）： 通常算作失败。
- 网络异常（Network Exception）： 算作失败。
- HTTP 5xx： 算作失败。
- HTTP 4xx（除 429 限流）： 通常不算失败，因为这是客户端问题。
- 业务自定义异常： 根据业务语义决定是否计入。
4.3.2 阈值选择参考
| 服务类型 | 推荐阈值 | 容忍度说明 |
|---|---|---|
| 核心交易链路 | 10% - 20% | 低容忍度，一旦超过 10% 即熔断，保护下游 |
| 非关键查询服务 | 30% - 50% | 可容忍一定比例失败，降级而非熔断 |
| 第三方依赖 | 25% - 40% | 考虑第三方不稳定因素，适当放宽 |
| 批量数据处理 | 50% - 70% | 允许部分失败，整体任务仍可继续 |
4.4 三个参数的协同关系
这三个参数不是独立配置的，它们共同决定了熔断器的触发条件。下面的流程图展示了完整的决策路径：
4.5 多环境校准实战要点
环境差异校准清单：
- 开发环境：滑动窗口 5 秒，请求数阈值 3，错误百分比 80%。低流量环境，阈值设低以便测试熔断逻辑。
- 测试环境：滑动窗口 10 秒，请求数阈值 10，错误百分比 50%。模拟中等流量，验证熔断准确性。
- 预发环境：滑动窗口 10 秒，请求数阈值 30，错误百分比 30%。接近生产配置，做最终验证。
- 生产环境：滑动窗口 10 秒，请求数阈值 100，错误百分比 20%。高流量，高要求，避免误判。
重要提醒：不要直接复制生产环境的参数到开发环境。开发环境流量低，请求数阈值 100 可能永远达不到，熔断器形同虚设。反之，生产环境使用开发环境的低阈值，会导致频繁误熔断。
4.6 参数配置示例（Resilience4j）
以下是一个基于 Resilience4j 的熔断器配置示例，展示了三个核心参数的具体设置：
// Resilience4j 熔断器配置示例
CircuitBreakerConfig config = CircuitBreakerConfig.custom()
// 滑动窗口类型：基于时间
.slidingWindowType(CircuitBreakerConfig.SlidingWindowType.TIME_BASED)
// 滑动窗口大小：10 秒
.slidingWindowSize(10)
// 最小请求数阈值：5
.minimumNumberOfCalls(5)
// 错误百分比阈值：50%
.failureRateThreshold(50)
// 等待时间（熔断打开后等待半开的时间）：5 秒
.waitDurationInOpenState(Duration.ofSeconds(5))
// 半开状态允许的请求数：3
.permittedNumberOfCallsInHalfOpenState(3)
.build();
CircuitBreaker circuitBreaker = CircuitBreaker.of("myService", config);在 YAML 配置文件中，同样的参数可以这样表达：
resilience4j.circuitbreaker:
configs:
default:
slidingWindowType: TIME_BASED
slidingWindowSize: 10
minimumNumberOfCalls: 5
failureRateThreshold: 50
waitDurationInOpenState: 5s
permittedNumberOfCallsInHalfOpenState: 3
instances:
myService:
baseConfig: default