Spring Boot 3中@ConditionalOnProperty未按预期创建Bean问题排查

以下是几个常见的原因及对应的排查/解决方法：

1. 属性匹配规则配置错误 #

• 核对@ConditionalOnProperty的参数与配置文件是否完全匹配：
  • 若配置为app.tree-strategy=custom，注解需写为@ConditionalOnProperty(name = "app.tree-strategy", havingValue = "custom")；如果使用prefix属性，要避免重复前缀，比如prefix = "app"时，name只需写tree-strategy，否则会匹配不存在的app.app.tree-strategy属性。
  • 注意大小写敏感：havingValue的值必须和配置文件中的值完全一致，比如配置写Custom而注解写custom会导致匹配失败。
  • 检查matchIfMissing属性：如果该属性设为true，当配置不存在时会创建Bean，但如果你的场景是必须匹配指定值，需确保matchIfMissing = false（默认值）。

2. 配置类未被Spring容器扫描 #

• 确认TreeStrategyConfig类添加了@Configuration注解，否则Spring不会处理该类中的Bean定义。
• 检查配置类所在包是否在Spring Boot主类的扫描范围内：@SpringBootApplication默认扫描主类所在包及其子包，若配置类在外部包，需添加@ComponentScan指定扫描路径。

3. 条件判断冲突或无匹配条件 #

• 检查两个TreeAlgorithmStrategy类型Bean的条件是否存在逻辑冲突：比如一个Bean的条件是havingValue = "custom"，另一个是havingValue = "default"，但配置值既不匹配custom也不匹配default，会导致没有Bean被创建。
• 开启Debug日志查看条件判断过程：在application.properties中添加logging.level.org.springframework.boot.autoconfigure=DEBUG，启动后搜索ConditionEvaluationReport，Spring会详细打印每个Bean的条件判断结果，直接定位未创建Bean的原因。

4. 依赖注入类型不匹配或Bean重复 #

• 确认CategoryTreeService的构造方法参数是TreeAlgorithmStrategy接口类型，而非具体实现类，否则即使接口Bean存在，也会因类型不匹配报错。
• 若两个TreeAlgorithmStrategyBean同时被创建（条件配置错误导致都满足），Spring会因无法确定注入哪个Bean报错，此时需给目标Bean添加@Primary注解，或在注入时用@Qualifier指定Bean名称。

5. 配置文件加载优先级问题 #

• 确认当前启动环境加载的是你修改的application.properties：比如启动时指定了--spring.profiles.active=dev，则会优先加载application-dev.properties，若该文件未设置app.tree-strategy，会使用默认值导致条件不匹配。

内容的提问来源于stack exchange，提问作者LUIS ANGEL SANTIAGO PALMA