Spring Boot条件注解（如@ConditionalOnProperty）仅在启动时生效，运行时修改配置不会触发Bean重建；必须确保配置值为字符串且严格匹配havingValue，避免matchIfMissing误用，并可通过数组或多属性联合判断或SpEL实现复杂逻辑。
要在Spring Boot中让条件注解真正按配置变化动态生效，必须理解它只在应用启动时扫描并决定Bean是否注册——运行时修改配置文件不会触发Bean重建或销毁。
确认@ConditionalOnProperty在启动阶段起效
Spring Boot的条件注解（包括@ConditionalOnProperty）仅在ApplicationContext刷新前的ConfigurationClassPostProcessor阶段执行一次。这意味着：配置值读取发生在容器初始化早期，之后无论你手动改application.properties还是通过Config Server推送新值，已加载的Bean不会自动替换、停用或重载。
这一步不可跳过，否则后续所有操作都建立在错误前提上。
验证方式：启动时在日志中搜索“Condition evaluated TRUE”或“did not match”，例如：Condition on @ConditionalOnProperty 'app.feature.cache.enabled' matched。
正确写法：把注解加在@Bean方法或@Configuration类上
方法一：作用于单个Bean
@Bean
@ConditionalOnProperty(name = "app.search.enabled", havingValue = "true")
public SearchService searchService() {
return new ElasticSearchService();
}
方法二：作用于整个配置类（更常用）
@Configuration
@ConditionalOnProperty(prefix = "app.payment", name = "gateway", havingValue = "alipay")
public class AlipayAutoConfiguration {
@Bean public AlipayClient alipayClient() { ... }
}
【name和havingValue必须严格匹配字符串值，不支持布尔类型自动转换】。比如havingValue = "true"不会匹配配置中的app.search.enabled=true若该值被YAML解析为Boolean类型——此时要用havingValue = "true"且确保配置文件里写的是字符串app.search.enabled: "true"。
避免踩坑：matchIfMissing参数的陷阱
默认matchIfMissing = false，即属性未定义时条件不成立，Bean不加载。
若设为true，则属性缺失时反而会加载Bean，容易造成误启用。例如：
@ConditionalOnProperty(name = "feature.audit.log", matchIfMissing = true)
开发环境没配这个key，结果审计日志功能悄悄打开了——线上可能因此打爆磁盘。
建议显式声明matchIfMissing = false，除非你明确需要“有配置才关，没配置默认开”的逻辑。
多属性联合判断：用数组传多个key
第一步：在application.yml中同时定义两个开关
feature.report.enabled: true
feature.export.format: csv
第二步：在@Bean上用name数组声明依赖关系
@Bean
@ConditionalOnProperty(
name = {"feature.report.enabled", "feature.export.format"},
havingValue = "true"
)
public ReportExporter csvReportExporter() { ... }
注意：所有数组中的属性都必须存在且等于havingValue才满足条件。这里会失败，因为feature.export.format的值是"csv"而非"true"——你应该改用havingValue = "csv"或换用SpEL表达式。
进阶技巧：配合@ConditionalOnExpression做复杂判断
当单一属性无法表达逻辑时，直接退回到SpEL：
@Bean
@ConditionalOnExpression("#{environment.getProperty('app.env') == 'prod' &&
environment.getProperty('app.feature.rate-limit', 'false').equals('true')}")
public RateLimiter prodRateLimiter() { ... }
这种写法绕过了@ConditionalOnProperty的限制，但失去了类型安全和IDE提示。只在必要时使用。
