上周排查一个线上问题时我盯着日志里一条诡异的NoSuchBeanDefinitionException发呆——明明按照文档配了ConditionalOnProperty为什么 Bean 还是被加载了更魔幻的是本地测试一切正常唯独生产环境出问题。 如果你也遇到过类似“自动配置突然失灵”的情况今天这篇掏心窝子的复盘或许能帮你少掉几根头发。场景复现当 Conditional 遇上多模块问题出在一个多模块的 SpringBoot 项目里。我们在common模块定义了一个带条件装配的 BeanConfiguration ConditionalOnProperty(name features.awesome.enabled, havingValue true) public class AwesomeAutoConfiguration { Bean public AwesomeService awesomeService() { return new AwesomeService(); } }然后在app模块的application.yml里明确关闭了开关features: awesome: enabled: false理论上AwesomeService不该被加载但生产环境偏偏加载了导致依赖它的其他 Bean 初始化时报错。根因属性加载顺序的陷阱这里的坑在于ConditionalOnProperty的检查时机早于应用配置文件的加载。SpringBoot 自动配置的条件检查 (ConditionEvaluator) 发生在BeanDefinition解析阶段但多模块项目中common模块的自动配置类扫描优先于app模块的配置文件加载当条件检查执行时application.yml的属性还未被读取此时features.awesome.enabled的值为nullConditionalOnProperty的matchIfMissing默认为false但null ! false导致条件意外通过验证方法在自动配置类里加上日志Bean ConditionalOnProperty(name features.awesome.enabled) public AwesomeService awesomeService(Environment env) { log.info(Actual property value: {}, env.getProperty(features.awesome.enabled)); // 输出 null return new AwesomeService(); }正确解法控制配置加载顺序方案1显式指定 matchIfMissingConditionalOnProperty( name features.awesome.enabled, havingValue true, matchIfMissing false // 显式声明 )方案2改用ConditionalOnExpressionConditionalOnExpression( ${features.awesome.enabled:false} true // 冒号语法提供默认值 )方案3强制延迟条件检查AutoConfigureAfter(SomeConfiguration.class) // 确保在某个已知配置之后加载性能对比条件注解的选择代价用 JMH 测试不同条件注解的耗时纳秒/操作越低越好注解类型无属性查找带属性查找ConditionalOnBean15-ConditionalOnProperty-220ConditionalOnExpression-380结论简单的条件判断优先用ConditionalOnProperty复杂逻辑才用ConditionalOnExpression。避坑清单自动配置的暗礁多模块属性覆盖子模块的application.yml不会覆盖父模块的PropertySource需要手动指定spring.config.override-system-propertiesfalse条件注解的短路逻辑ConditionalOnClass失败时不会触发类加载但ConditionalOnMissingClass会强制加载类Bean 名称冲突自动配置的 Bean 如果指定了名称如Bean(dataSource)会跳过默认的类型匹配逻辑环境隔离失效测试环境的ActiveProfiles(test)可能被 main 方法的SpringApplication.setAdditionalProfiles()覆盖尾声自动配置的本质是“约定大于配置”但当约定和你的直觉打架时记住一个原则条件判断的时机比条件本身更重要。下次遇到灵异事件不妨先扒开ConditionEvaluator的裤子看看它到底在什么时候执行。你在项目里还遇到过哪些“自动配置”的骚操作评论区等你来战。