Spring Boot多项目集成时@ComponentScan部分扫描配置失效问题

核心是Spring组件扫描的分层执行逻辑：

1. 应用启动第一阶段，只会解析启动类IhubApplication上@SpringBootApplication定义的scanBasePackages = { "com.abc.xyz.pqr" }规则，仅扫描该路径及其子包下的所有组件，包括@Configuration标记的配置类。
2. 只有被第一阶段初始扫描成功加载到容器的@Configuration类，其上声明的额外@ComponentScan规则才会被解析执行，进而扫描其他路径的组件。

两个项目加载差异的原因：

• 配置com.abc.xyx扫描路径的项目2，其CustomConfig配置类本身位于com.abc.xyz.pqr及其子包下，被初始扫描成功识别加载，因此它定义的扫描规则正常执行，对应组件被正常加载。
• 配置com.pqr.abc扫描路径的项目1，其CustomConfig配置类属于com.pqr.abc包层级，完全不在初始扫描的com.abc.xyz.pqr路径范围内，Spring启动阶段根本不会感知到这个配置类的存在，它定义的扫描规则完全不会触发，因此对应路径下的组件全部被忽略。

根据项目场景选择任意一种方案即可：

• 扩展启动类扫描范围
  将项目1配置类所在的根包添加到启动类的scanBasePackages配置中，让初始扫描可以直接识别到项目1的配置类：

  @SpringBootApplication(scanBasePackages = { "com.abc.xyz.pqr", "com.pqr.abc" })
  public class IhubApplication {}
  

  如果项目1的所有组件本身都在com.pqr.abc路径下，配置后可以直接移除项目1CustomConfig上的@ComponentScan，初始扫描会直接加载该路径下的所有组件。

• 使用@Import直接导入配置类
  如果不想扩大初始扫描范围，可以在启动类上直接导入两个依赖项目的配置类，跳过扫描识别流程强制加载配置类：

  @SpringBootApplication(scanBasePackages = { "com.abc.xyz.pqr" })
  @Import({com.pqr.abc.CustomConfig.class, com.abc.xyx.CustomConfig.class})
  public class IhubApplication {}
  

  导入后两个配置类都会被正常加载，其上定义的所有扫描规则都会正常执行。

• 依赖项目配置Spring Boot自动装配
  如果是公共依赖库，推荐在依赖侧配置自动装配，主应用不需要做额外扫描配置：

  • Spring Boot 2.7+版本：在依赖项目的resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件中，添加配置类的全限定名：

    com.pqr.abc.CustomConfig
    

  • Spring Boot 2.7以下版本：在依赖项目的resources/META-INF/spring.factories文件中添加配置：

    org.springframework.boot.autoconfigure.EnableAutoConfiguration=com.pqr.abc.CustomConfig
    

  配置后主应用启动时会自动加载依赖中的配置类，无需额外扫描配置。

内容的提问来源于stack exchange，提问作者chethan bhounsley g