用途:在 Spring Boot 3.x 中实现容错,防止级联失败,适用于调用外部服务、处理瞬时故障、限流与资源隔离等场景。
主要能力:提供断路器、重试、限流器、舱壁(信号量与线程池)、时间限制器及回退方法等 Resilience4j 模式,并支持多模式叠加使用。
使用方式:引入依赖,Maven 添加 io.github.resilience4j:resilience4j-spring-boot3:2.2.0、spring-boot-starter-aop、spring-boot-starter-actuator;Gradle 使用 implementation "io.github.resilience4j:resilience4j-spring-boot3:2.2.0" 等。在方法上使用 @CircuitBreaker、@Retry、@RateLimiter、@Bulkhead、@TimeLimiter 注解并指定 fallbackMethod,在 application.yml 的 resilience4j 下配置实例参数。多模式叠加执行顺序为 Retry → CircuitBreaker → RateLimiter → Bulkhead → Method。可通过 Actuator 暴露 health、metrics、circuitbreakers、retries、ratelimiters 端点监控。
限制:回退方法需与原方法签名一致并可附加异常参数;断路器状态按实例隔离;重试操作须幂等,谨慎用于 POST 等非幂等操作;限流可能阻塞线程;线程池舱壁高并发时需关注内存;必须始终完成的操作不宜用断路器而应用超时。具体配置项与测试策略见技能内参考文档。