Java中 Resilience4j 怎么配置熔断器 CircuitBreaker 响应特定异常-java教程-PHP中文网

resilience4j 的 circuitbreaker 默认将所有异常视为失败，需通过 recordexceptions 指定触发熔断的异常（如 ioexception、timeoutexception），用 ignoreexceptions 排除不计数的异常（如 illegalargumentexception），二者共存时后者优先；配置后结合 fallback 可实现精准降级，且须通过 metrics 或事件监听验证生效。

java中 resilience4j 怎么配置熔断器 circuitbreaker 响应特定异常

Resilience4j 的 CircuitBreaker 默认只对抛出的异常（即非受检异常）进行失败统计，但**不会自动区分异常类型**——它默认把所有异常都当作失败事件。若要让熔断器仅对特定异常（如 TimeoutException、IOException）触发失败计数，而忽略其他异常（如 IllegalArgumentException），需通过 自定义 recordExceptions 和 ignoreExceptions 配置 实现。

1. 指定哪些异常触发熔断（recordExceptions）

使用 recordExceptions 明确列出需要计入失败率的异常类。只有这些异常被抛出时，才会增加失败计数、影响熔断状态。

支持子类匹配：例如配置 IOException.class，则 SocketTimeoutException、ConnectException 等子类也会被记录
配置方式（Java DSL）：

CircuitBreakerConfig config = CircuitBreakerConfig.custom()
    .failureRateThreshold(50) // 失败率超50%开启熔断
    .waitDurationInOpenState(Duration.ofSeconds(60))
    .slidingWindowSize(10)
    .recordExceptions(IOException.class, TimeoutException.class)
    .build();

2. 指定哪些异常不触发熔断（ignoreExceptions）

用 ignoreExceptions 声明某些异常应被完全忽略——即使它们发生，也不会影响失败计数、不会导致熔断，适合业务校验类异常（如参数错误、权限拒绝）。

Java Maven Code Review

审查Java Maven项目（ZIP压缩包或GitLab仓库URL），检查代码规范、命名、模块边界、可维护性问题以及重复代码。

下载

ignoreExceptions 和 recordExceptions 可同时使用；若某异常同时出现在两者中，ignoreExceptions 优先级更高（即被忽略）
常见忽略场景：用户输入非法、Token过期、401/403响应封装成的运行时异常
示例：

.recordExceptions(IOException.class, TimeoutException.class)
.ignoreExceptions(IllegalArgumentException.class, SecurityException.class)

3. 配合 fallback 使用更精准的错误处理

配置好异常策略后，在调用处结合 decorateCheckedSupplier 或 decorateSupplier + fallback，可实现“特定异常走降级，其他异常直接抛出”：

例如：网络异常走缓存 fallback，参数异常仍向上抛出供上层统一校验处理
代码示意：

Supplier<string> decorated = CircuitBreaker
    .decorateSupplier(circuitBreaker, () -> callExternalApi())
    .andThen(fallbackToCache()); // 仅当 circuitBreaker 开启或失败时触发

// 注意：fallback 不会拦截被 ignore 的异常 —— 它们根本不会进入熔断判断流程
</string>