CircuitBreaker Fallback方法失效及Actuator状态异常问题求助

一、Billing服务自身CircuitBreaker异常现象及排查 #

现象 #

发送GET请求localhost:8765/billing/hi时，Billing服务启动状态下能正常返回"Hello Khushboo!"；但停止Billing服务后再次请求，CircuitBreaker降级方法未触发，且Actuator Health状态中无断路器信息。

排查思路 #

• 请求路由逻辑验证：停止Billing服务后，localhost:8765/billing/hi的请求是直接打给网关，而非Billing服务实例。此时服务已停止，请求根本无法到达标注@CircuitBreaker的方法，自然不会触发降级逻辑——断路器是服务内部的容错组件，服务离线时无法执行其逻辑。
• 断路器触发条件检查：配置中minimumNumberOfCalls=5，要求至少5次失败调用才会触发断路器。但服务停服后，请求无法到达服务端，这些请求不会被计入断路器的统计样本中，达不到触发阈值。
• Actuator配置有效性验证：通过/actuator/env端点确认以下配置是否正确加载：
  • management.health.circuitbreakers.enabled=true
  • resilience4j.circuitbreaker.instances.BillingServiceCapture.registerHealthIndicator=true
    若配置未加载，检查配置文件路径、格式是否正确。
• 依赖完整性检查：确认项目已引入对应Spring Boot版本的resilience4j-spring-boot3（或resilience4j-spring-boot2）和spring-boot-starter-actuator依赖，缺失依赖会导致断路器或Actuator功能失效。

二、OrderService调用Billing时CircuitBreaker未触发问题 #

现象 #

未启动Billing服务时，调用http://localhost:8765/order/bookorder抛出500异常，错误信息：

[503] during [GET] to [http://billing-service/billing/preparebill] [BillingProxy#getBillingDone(Billing)]: [Load balancer does not contain an instance for the service billing-service]

但CircuitBreaker未触发降级方法。

排查思路 #

• Fallback方法签名不匹配：原方法saveOrder返回类型为TransactionResponse，但降级方法getAllBillingDetails返回Billing，且参数列表仅包含Billing和Exception，与原方法参数TransactionRequest不匹配。Resilience4j要求Fallback方法必须与原方法返回类型一致，且参数列表为原方法所有参数 + Exception。正确示例：

  public TransactionResponse getAllBillingDetails(TransactionRequest request, Exception e) {
      Order order = request.getOrder();
      return new TransactionResponse(order, "fallback-trans-id", 0.0, "Payment processing fallback");
  }
  

• 断路器作用时机调整：负载均衡找不到实例时抛出的异常发生在Feign调用执行前，若@CircuitBreaker标注在业务方法saveOrder上，可能无法捕获该阶段的异常。建议将@CircuitBreaker直接标注在Feign接口的方法上，或通过配置开启Feign与Resilience4j的整合（添加feign.circuitbreaker.enabled=true到OrderService的配置文件）。
• 断路器配置缺失检查：OrderService中是否配置了resilience4j.circuitbreaker.instances.BillingServiceCapture相关参数？若未配置，断路器会使用默认阈值，可能无法触发降级。
• 异常捕获范围配置：Resilience4j默认捕获Exception子类，但可通过resilience4j.circuitbreaker.instances.BillingServiceCapture.recordExceptions明确指定需要捕获的异常类型，例如添加java.lang.IllegalStateException（负载均衡无实例时抛出的异常类型），确保异常被计入断路器统计。

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