添加模块依赖是否启用组件扫描？Spring Boot多模块扫描机制答疑

核心原因：默认扫描规则 + 类路径合并 #

你遇到的现象本质是Spring Boot默认组件扫描规则，结合Maven多模块依赖的类路径特性共同作用的结果，具体拆解如下：

1. @SpringBootApplication的默认扫描逻辑 #

@SpringBootApplication是组合注解，核心包含@ComponentScan——它负责扫描并注册Spring组件（包括@Component、@Service、@Repository、@Controller以及JPA的@Entity等）。

• 如果没有显式指定basePackages或basePackageClasses参数，@ComponentScan会以标注该注解的类所在的包作为根扫描包，递归扫描这个包及其所有子包下的所有符合条件的类。

2. 多模块依赖的类路径特性 #

你的项目中模块A依赖模块B，当启动模块B时，Maven会将模块A的编译产物（class文件或jar包）加入到模块B的运行类路径中。这意味着：

• 模块A中com.x.y及其子包下的类，和模块B自身com.x.y下的类，在JVM的类路径里属于同一个逻辑包空间。
• Spring的包扫描只认类的全限定名，不会区分这些类来自哪个模块，只要全限定名落在扫描范围内，就会被识别并加载为Bean。

3. 为什么无需显式配置？ #

因为你在模块B中声明@SpringBootApplication的类所在包是com.x.y，而模块A的组件恰好也在com.x.y及其子包下，完全命中了默认扫描的范围，加上类路径合并让模块A的类能被Spring检测到，所以不需要额外配置扫描路径就自动生效了。

官方指南补充说明 #

Spring Boot官方多模块配置指南中明确提到：在多模块项目里，如果启动类所在的包是所有模块的共同父包，Spring Boot的默认扫描机制会自动覆盖所有模块中对应包结构下的组件，无需手动配置@ComponentScan的扫描范围。

内容的提问来源于stack exchange，提问作者Harsha Limaye