Resilience4j 的 CircuitBreaker 不会一直 OPEN，需显式配置 waitDurationInOpenState（建议30000毫秒）并合理设置 eventConsumerBufferSize（如1024），同时确保 @CircuitBreaker 注解在 Spring AOP 代理下生效、正确区分 fallbackMethod 与 ignoreExceptions。
Resilience4j 的 CircuitBreaker 怎么配才不会一直 OPEN？
熔断器老是卡在 OPEN 状态不恢复，大概率是配置了错误的 waitDurationInOpenState 或漏掉了状态监听回调。Resilience4j 默认不自动重试，OPEN 后必须等满等待时间才进 HALF_OPEN，期间所有调用直接失败。
-
waitDurationInOpenState必须显式设置，单位毫秒，建议从 30000（30 秒）起步，别用默认值（它其实是 60 秒，但容易误以为“没生效”） - 如果依赖定时探测后端是否恢复，得自己加
onStateTransition回调，在 HALF_OPEN 时触发一次试探性调用 - 注意：
failureRateThreshold是滑动窗口内的失败率，默认窗口大小 100 次调用——QPS 低的服务可能半天都凑不够 100 次，导致熔断器压根不触发 - 测试时别只跑单次异常，要用循环快速打满窗口次数，否则看不出状态切换
Spring Boot 项目里怎么让 @CircuitBreaker 注解生效？
注解不生效最常见原因是没开 AOP 代理或切面没覆盖到目标类。Resilience4j 的 @CircuitBreaker 是基于 Spring AOP 实现的，不是编译期织入。
- 确认引入了
resilience4j-spring-boot2（Spring Boot 2.x）或resilience4j-spring-boot3（Boot 3.x），别混用 - 确保目标方法是 public 的，且调用发生在 Spring 容器管理的 Bean 内部（即不能在 new 出来的对象里调用）
- 检查类上有没有
@EnableCircuitBreaker（旧版）或是否启用resilience4j.circuitbreaker.instances.xxx.enabled=true配置 - 如果用了 Lombok 的
@RequiredArgsConstructor，注意构造器注入的 Bean 是否被 AOP 代理包裹——有时需要加@Lazy避免循环依赖干扰代理创建
降级逻辑写在 fallbackMethod 还是 ignoreExceptions？
这两者解决的是完全不同的问题：fallbackMethod 是业务兜底，ignoreExceptions 是告诉熔断器“这个异常不算失败”。混用会导致降级不触发或熔断失灵。
- 需要返回默认值（比如缓存数据、空列表）→ 用
fallbackMethod，方法签名必须和原方法一致，且参数末尾多一个Throwable - 某些异常是预期中的（如
IllegalArgumentException参数校验失败）→ 加进ignoreExceptions，它不会触发熔断，也不走 fallback - 注意：
fallbackMethod抛出的异常不会被再捕获，会原样向上抛，所以里面别再 throw 新异常 - 如果降级方法执行也超时，Resilience4j 不会再套一层熔断——得靠外层
TimeLimiter单独配超时
为什么本地跑得好，上线就频繁 fallback？
环境差异主要在线程模型和监控粒度。Resilience4j 默认用共享的全局事件循环（EventProcessor），高并发下事件堆积会导致状态更新延迟，熔断判断滞后。
立即学习“Java免费学习笔记（深入）”；
- 生产环境务必配置独立线程池：
resilience4j.circuitbreaker.backends.default.eventConsumerBufferSize=1024（默认 100，小流量够用，大流量必调大） - 检查 JVM 参数是否限制了可用 CPU 数（如容器里没设
-XX:ActiveProcessorCount），影响ScheduledThreadPoolExecutor的调度精度 - 别把
CircuitBreakerRegistry声明成 static 单例——Spring Boot 自动配置已提供线程安全的 bean，重复管理反而引发状态混乱 - 日志里搜
CircuitBreakerOnStateTransitionEvent，确认状态变更是否及时；如果 HALF_OPEN 到 CLOSED 的日志隔很久才出现，基本就是事件队列堵了
真正难调的不是参数本身，而是滑动窗口、事件队列、线程调度三者在不同负载下的耦合行为。先稳住 waitDurationInOpenState 和 eventConsumerBufferSize，再观察指标，别一上来就调 ringBufferSizeInHalfOpenState。
