Resilience4j CircuitBreaker主后端不可用时首次调用直接触发fallback求助

结论：你的预期不正确，问题核心是对fallback触发逻辑和熔断参数的理解有误 #

原因分析 #

• fallback触发逻辑误解：@CircuitBreaker注解的fallbackMethod不是仅在熔断器打开时才触发，只要被注解的方法执行抛出异常，不管熔断器处于关闭/半开状态，都会优先匹配对应的fallback方法执行，这是框架自带的异常降级逻辑，和熔断器状态没有绑定关系。你预期的“直接报错”是没有配置fallback时的表现，只要配置了fallback所有异常都会先走降级。
• 熔断参数配置错误：failureRateThreshold参数的单位是百分比，你配置的4代表失败率超过4%就触发熔断，而非累计4次失败。按当前配置，累计5次调用里只要有1次失败，失败率就达到20%，远高于4%的阈值，满足minimumNumberOfCalls=5的条件后熔断器会立刻打开。

解决方案 #

如果要实现“前5次失败直接抛出异常，第6次调用才触发熔断走fallback”的预期效果，按如下步骤修改：

1. 调整熔断参数，设置100%失败率才触发熔断：

@Bean
public CircuitBreakerConfig circuitBreakerConfig() {
    return CircuitBreakerConfig.custom()
            .slidingWindowType(CircuitBreakerConfig.SlidingWindowType.COUNT_BASED)
            .slidingWindowSize(5)
            .minimumNumberOfCalls(5)
            .failureRateThreshold(100)
            .build();
}

2. 调整fallback逻辑，仅在熔断器打开时执行降级，其余场景抛出原异常：

import io.github.resilience4j.circuitbreaker.CallNotPermittedException;

public String fallbackA(Exception e) {
    // 仅熔断器打开抛出的CallNotPermittedException才走降级
    if (e instanceof CallNotPermittedException) {
        return restTemplate.getForObject("http://localhost:8080/partner", String.class);
    }
    // 熔断器关闭状态下的调用失败直接抛出异常
    throw e;
}

通用排查步骤 #

如果修改后问题仍然存在，按如下顺序排查：

• 确认熔断器配置正确绑定到backendA实例：Spring Boot项目中yaml配置优先级高于Bean配置，推荐统一用yaml配置避免冲突：

resilience4j:
  circuitbreaker:
    instances:
      backendA:
        sliding-window-type: count_based
        sliding-window-size: 5
        minimum-number-of-calls: 5
        failure-rate-threshold: 100

• 开启Resilience4j debug日志，观察每次调用后熔断器的状态、指标变化，确认参数是否生效：

logging:
  level:
    io.github.resilience4j: debug

• 确认被@CircuitBreaker注解的方法是通过Spring代理调用，不要在同类内部直接调用该方法，否则注解会失效。

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