Spring Boot多模块下如何按需加载@ConditionalOnProperty注解Bean？

核心结论 #

对于这种独立业务模块（无Spring Boot启动类）的场景，使用spring.factories或Spring Boot 2.7+的org.springframework.boot.autoconfigure.AutoConfiguration.imports是模块化架构的标准方案，比手动@Import更契合Spring Boot自动配置的设计理念，也更便于模块的复用与解耦。

两种方案的对比分析 #

1. 自定义@Configuration + @Import 方案 #

• 实现方式：在tree-engine模块中创建标注@Configuration的类，通过@ComponentScan精准扫描该模块需暴露的Bean（比如仅扫描TreeAlgorithmStrategy接口及其实现类所在包），或直接用@Bean手动注册实现类；随后在主模块的启动类或配置类上用@Import导入此配置类。

  // tree-engine模块的配置类
  @Configuration
  @ComponentScan(basePackages = "com.example.treeengine.strategy")
  public class TreeEngineAutoConfig {
  }
  
  // 主模块启动类
  @SpringBootApplication
  @Import(TreeEngineAutoConfig.class)
  public class AppApplication {
      public static void main(String[] args) {
          SpringApplication.run(AppApplication.class, args);
      }
  }
  

• 优缺点：简单直接，适合小型项目或临时场景，但需要主模块显式导入配置类，模块复用性较差——其他项目依赖tree-engine时，必须手动添加@Import，容易遗漏。

2. 自动配置注册方案（官方标准推荐） #

Spring Boot的自动配置机制正是为解决这类模块化Bean注册问题设计的，无需主模块显式声明，仅需在tree-engine模块完成自动配置注册即可：

方式一：Spring Boot 2.7+ 推荐使用 org.springframework.boot.autoconfigure.AutoConfiguration.imports

• 在tree-engine模块的src/main/resources/META-INF/spring/目录下创建文件org.springframework.boot.autoconfigure.AutoConfiguration.imports，内容为自动配置类的全限定名：

  com.example.treeengine.config.TreeEngineAutoConfig
  

• 自动配置类写法与上述一致，可结合@ConditionalOnClass等注解做更灵活的条件判断：

  @Configuration
  @ComponentScan(basePackages = "com.example.treeengine.strategy")
  // 可选：仅当主模块引入TreeAlgorithmStrategy相关类时生效
  @ConditionalOnClass(TreeAlgorithmStrategy.class)
  public class TreeEngineAutoConfig {
  }
  

方式二：旧版本（Spring Boot <2.7）使用 spring.factories

• 在tree-engine模块的src/main/resources/META-INF/目录下创建spring.factories文件，添加自动配置类注册：

  org.springframework.boot.autoconfigure.EnableAutoConfiguration=com.example.treeengine.config.TreeEngineAutoConfig
  

• 优缺点：完全符合Spring Boot模块化设计理念，主模块只需依赖tree-engine模块，Spring Boot会自动发现并加载其自动配置类，无需额外代码。模块复用性极强，其他项目依赖时无需额外配置即可自动生效。同时，你已使用的@ConditionalOnProperty注解依然能正常工作——Spring Boot会根据主模块的配置属性，决定实例化哪个实现类，完全满足你的需求。

总结 #

优先选择自动配置注册方案（AutoConfiguration.imports或spring.factories），这是Spring Boot官方推荐的模块化组件开发标准方式，能最大化模块的复用性与可维护性，降低主模块的耦合度。

内容的提问来源于stack exchange，提问作者JOSUE RAFAEL PEREZ AGUIRRE