3. Resilience4j 核心模块概览

Resilience4j 是一个专为 Java 8 和函数式编程设计的轻量级容错库，其核心模块遵循“单一职责”原则，每个模块只处理一种特定的弹性模式。在 Spring Boot 开发环境中，理解这五个核心模块——CircuitBreaker、RateLimiter、Retry、TimeLimiter、Bulkhead——是进行参数调优的前提。

3.1 五大模块功能对比

3.2 模块协作关系与架构

下图展示了五个核心模块在微服务调用链路中的典型协作关系。一个外部请求依次经过 Bulkhead（并发隔离）、TimeLimiter（超时控制）、RateLimiter（速率限制）、CircuitBreaker（熔断保护）和 Retry（失败重试），最终到达下游服务。

3.3 各模块核心参数速览

在进行参数调优之前，需要熟悉每个模块的关键配置项。下表列出了各模块最核心的调优参数及其默认值：

3.4 模块组合使用示例

在实际项目中，通常需要将多个模块组合使用。以下是一个典型的组合配置示例，展示了如何在 Spring Boot 中同时启用 CircuitBreaker 和 Retry：

// application.yml 配置示例
resilience4j:
  circuitbreaker:
    configs:
      default:
        sliding-window-size: 10
        failure-rate-threshold: 50
        wait-duration-in-open-state: 10000
        permitted-number-of-calls-in-half-open-state: 3
    instances:
      userService:
        base-config: default
  retry:
    configs:
      default:
        max-attempts: 3
        wait-duration: 500
        retry-exceptions:
          - java.io.IOException
    instances:
      userService:
        base-config: default

3.5 模块选择决策流程

在微服务开发中，如何选择正确的模块组合？以下决策流程可以帮助你快速判断：

1. 是否需要限制并发数？ → 是 → 使用 Bulkhead（线程池隔离或信号量隔离）
2. 是否需要控制调用超时？ → 是 → 使用 TimeLimiter（设置合理的 timeoutDuration）
3. 是否需要限制请求速率？ → 是 → 使用 RateLimiter（根据下游处理能力配置 limitForPeriod）
4. 是否需要防止级联故障？ → 是 → 使用 CircuitBreaker（配置滑动窗口和阈值）
5. 是否需要自动重试临时故障？ → 是 → 使用 Retry（注意设置退避策略和最大重试次数）

3.6 模块状态与事件监听

每个模块都提供了事件监听机制，方便在调优过程中观察其行为。以下是一个 CircuitBreaker 状态变更事件的监听示例：

@Component
public class CircuitBreakerEventListener {

    @EventListener
    public void onCircuitBreakerEvent(CircuitBreakerEvent event) {
        if (event instanceof CircuitBreakerOnStateTransitionEvent) {
            CircuitBreakerOnStateTransitionEvent stateEvent =
                (CircuitBreakerOnStateTransitionEvent) event;
            log.info("CircuitBreaker [{}] 状态变更: {} -> {}",
                stateEvent.getCircuitBreakerName(),
                stateEvent.getFromState(),
                stateEvent.getToState());
        }
    }
}

通过监听这些事件，可以在调优过程中实时掌握模块的工作状态，为参数调整提供数据支撑。