使用Resilience4j CircuitBreaker时，@RestControllerAdvice异常处理器失效求助

1. 确保CircuitBreaker的ignoreExceptions配置生效 #

你之前尝试忽略异常但无效，大概率是配置方式不对，分两种场景确认：

注解方式配置 #

如果用@CircuitBreaker注解，需明确指定ignoreExceptions属性，填写自定义异常的全类名：

@CircuitBreaker(name = "serviceCircuitBreaker", ignoreExceptions = CustomBizException.class)
public void coreBusinessMethod() {
    // 核心业务逻辑，直接抛出CustomBizException
}

配置文件方式（application.yml） #

如果是全局配置，确保路径正确，针对目标CircuitBreaker实例或全局默认配置：

resilience4j:
  circuitbreaker:
    configs:
      default:
        ignore-exceptions: com.yourpackage.exception.CustomBizException
    instances:
      serviceCircuitBreaker:
        base-config: default

注意：若指定特定实例，需把ignore-exceptions配置到对应实例下，避免实例未继承默认配置。

2. 调整Fallback方法逻辑（若必须保留Fallback） #

如果CircuitBreaker必须配置降级Fallback，可在Fallback方法中判断异常类型，若为自定义业务异常则重新抛出，让全局异常处理器捕获：

public void coreBusinessMethodFallback(Throwable throwable) {
    if (throwable instanceof CustomBizException) {
        // 重新抛出异常，交给@RestControllerAdvice处理
        throw (CustomBizException) throwable;
    }
    // 其他异常执行降级逻辑
    // ...
}

这样既保留非业务异常的降级能力，又让自定义业务异常流向全局处理器。

3. 同步配置Retry的异常忽略（若用到@Retry） #

如果同时使用@Retry，需确保Retry不拦截自定义异常，否则重试后抛出的异常仍会被CircuitBreaker捕获：

@Retry(name = "serviceRetry", ignoreExceptions = CustomBizException.class)
@CircuitBreaker(name = "serviceCircuitBreaker", ignoreExceptions = CustomBizException.class)
public void coreBusinessMethod() {
    // ...
}

或在配置文件中同步配置Retry的ignore-exceptions。

4. 验证全局异常处理器的有效性 #

检查@RestControllerAdvice配置：

• 确保注解未限制扫描范围（若加了basePackages，需包含抛出异常的服务/控制器所在包）
• @ExceptionHandler的异常类型需准确匹配自定义异常：

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(CustomBizException.class)
    public ResponseEntity<ErrorResponse> handleCustomBizException(CustomBizException ex) {
        ErrorResponse error = new ErrorResponse(ex.getCode(), ex.getMessage());
        return new ResponseEntity<>(error, HttpStatus.BAD_REQUEST);
    }
}

是否需要放弃思路？ #

完全不需要。业务逻辑与异常处理分离是合理的架构设计，能让服务专注核心业务，也便于统一维护异常响应格式。只要调整上述配置和Fallback逻辑，就能实现你的需求。

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