Spring Boot/Cloud升级后Resilience4j断路器异常求助

问题背景 #

升级Spring Boot和Spring Cloud依赖后，Resilience4j断路器行为不符合预期，测试用例失败。核心依赖变更如下：

• Spring Boot：3.3.7 → 3.4.1
• Spring Cloud Dependencies：2023.0.1 → 2024.0.0
• Resilience4j核心版本：2.1.0 → 2.2.0
• 使用的Spring Cloud CircuitBreaker Starter版本：3.1.3（曾升级至3.2.0无效）

断路器配置未修改，核心配置如下：

resilience4j:
  circuitbreaker:
    configs:
      shared:
        sliding-window-type: count_based
        sliding-window-size: 10
        minimum-number-of-calls: 10
        failure-rate-threshold: 90
        slow-call-rate-threshold: 90
        slow-call-duration-threshold: 50ms
        wait-duration-in-open-state: 1s
        permitted-number-of-calls-in-half-open-state: 5
        max-wait-duration-in-half-open-state: 0s
        writable-stack-trace-enabled: true
        automatic-transition-from-open-to-half-open-enabled: true
        register-health-indicator: true
    instances:
      XXXXXService:
        base-config: shared

排查方向与解决方案 #

1. 核对Resilience4j 2.2.0的行为变更 #

Resilience4j 2.2.0针对CircuitBreaker做了部分逻辑修复，重点关注：

• 半开状态调用处理：修复了半开状态下调用计数的边界问题，若旧测试用例依赖"半开调用计数不严格"的逻辑，需调整测试场景。
• 状态切换时机：automatic-transition-from-open-to-half-open-enabled配置逻辑未变，但新版本对状态切换的时机判断更严格，需确认wait-duration-in-open-state计时是从断路器进入open状态开始准确计算。
• 慢调用统计：优化了基于计数的滑动窗口的慢调用统计逻辑，若测试用例模拟的慢调用处于阈值边缘，需重新验证超时时间设置是否符合预期。

2. 验证配置实际生效情况 #

通过代码打印断路器实际配置，确认yaml配置是否被正确加载：

@Autowired
private CircuitBreakerRegistry circuitBreakerRegistry;

public void printCircuitBreakerConfig() {
    CircuitBreaker circuitBreaker = circuitBreakerRegistry.find("XXXXXService").get();
    CircuitBreakerConfig config = circuitBreaker.getCircuitBreakerConfig();
    System.out.println("滑动窗口大小: " + config.getSlidingWindowSize());
    System.out.println("半开状态允许调用数: " + config.getPermittedNumberOfCallsInHalfOpenState());
    // 打印其他关键配置项
}

若实际配置与yaml不一致，需检查是否存在环境变量、系统属性等优先级更高的配置覆盖。

3. 检查依赖冲突 #

使用构建工具命令确认Resilience4j版本统一：

• Maven：mvn dependency:tree | grep io.github.resilience4j
• Gradle：./gradlew dependencies | grep resilience4j
  确保所有Resilience4j相关依赖均为2.2.0版本，无旧版本残留导致的逻辑冲突。

4. 调整测试用例适配新版本逻辑 #

若旧测试用例基于Resilience4j 2.1.0行为编写，需针对以下场景调整：

• 半开状态测试：确保在open状态等待wait-duration-in-open-state（1s）后再触发调用，验证5次半开调用的失败率是否达到阈值（90%），观察断路器状态切换是否符合预期。
• 慢调用测试：延长慢调用模拟时间至超过slow-call-duration-threshold（50ms），确保统计逻辑能正确识别慢调用。

5. 确认Spring Cloud CircuitBreaker适配逻辑 #

Spring Cloud 2024.0.0（Leyton）与Resilience4j 2.2.0适配逻辑无重大变更，但需确保：

• 断路器实例名称（XXXXXService）与@CircuitBreaker注解中的name属性完全匹配。
• 若使用编程式断路器，初始化方式未因Spring Boot 3.4.1的Bean生命周期变化而受影响。

内容的提问来源于stack exchange，提问作者Subhash