Spring Boot部署AWS环境时Resilience4j配置未读取问题

核心根因 #

两个问题叠加导致AWS Linux环境配置失效：

• 代码与配置的实例名不匹配：你在application.yml中定义的熔断器实例ID为backendA，但业务代码调用circuitBreakerFactory.create()时传入的实例名是backendTest，二者完全不对应。本地Windows环境因为NTFS文件系统大小写不敏感，加上Spring Boot配置绑定在Windows环境下的容错逻辑，会出现配置误加载的偶现正常现象，但Linux环境下实例名匹配是严格精确匹配，找不到对应实例配置时会直接回退到默认参数。
• 组件版本存在已知Linux兼容缺陷：你使用的spring-cloud-starter-circuitbreaker-resilience4j 2.1.3版本，自动配置模块存在资源加载大小写敏感bug：该版本打包时，Resilience4jProperties配置绑定类的注册路径存在大小写拼写偏差，Windows文件系统对路径大小写不敏感可以正常读取到配置元数据完成yml绑定，但Amazon Linux使用的xfs/ext4文件系统严格区分大小写，会直接跳过resilience4j前缀下的配置绑定流程，所有熔断器实例默认使用全局默认配置。

手动声明Customizer<Resilience4JCircuitBreakerFactory>Bean能正常生效的原因是：这类自定义Bean由Spring容器直接扫描注册，优先级高于自动配置的yml属性绑定逻辑，完全绕开了存在bug的自动配置加载流程，所以不受配置加载失败的影响，但这种写法属于问题规避，不是组件规范要求的必要实现。

修复步骤 #

• 统一实例名：将yml中配置的熔断器实例ID与代码中create()方法传入的实例名保持完全一致，注意Linux环境下大小写也要完全匹配，例如统一修改为backendTest。
• 修复版本兼容问题：将spring-cloud-starter-circuitbreaker-resilience4j升级到2.1.4及以上的2.1.x稳定版本，该版本已经修复了Linux环境下配置元数据路径大小写不匹配的bug，升级后不需要额外编写自定义配置Bean，组件会自动读取yml中的配置完成初始化。如果暂时无法升级依赖，可以在启动类上添加注解@ConfigurationPropertiesScan("io.github.resilience4j.circuitbreaker.autoconfigure")，强制Spring扫描Resilience4j的配置属性类，绕过自动配置的资源加载缺陷。
• 验证修复：在AWS环境启动应用时添加JVM参数-Dlogging.level.io.github.resilience4j=DEBUG，观察启动日志，如果出现对应实例名的配置加载日志，即证明yml配置已被正确识别。

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