Gradle多模块项目：非启动模块的Bean无法被Spring扫描注入

项目结构 #

Parent module
   -- module 1
   -- module2 (SpringBootApplication类所在模块)
   -- common module (定义了ABC.java接口)

• 所有模块的包路径均以com.xxx开头
• 已在module2的@SpringBootApplication注解中配置scanBasePackages = {"com.xxx"}
• module1和module2中均存在实现ABC.java接口的Bean

异常现象 #

自动注入ABC接口时，仅module2中的Bean能被成功注入，module1中的Bean完全未被Spring扫描到。已确认基础包扫描配置无问题，且相同结构的Maven项目可正常运行。

1. 确认module2是否依赖module1 #

Spring Boot仅能扫描当前模块及已依赖模块内的Bean。打开module2的pom.xml（Gradle项目为build.gradle），检查是否添加了module1的依赖：

<!-- Maven示例 -->
<dependency>
    <groupId>com.xxx</groupId>
    <artifactId>module1</artifactId>
    <version>对应版本号</version>
</dependency>

若未添加该依赖，Spring无法感知module1内的类，自然无法扫描到对应Bean。

2. 检查module1的Bean注解是否正确 #

确认module1中实现ABC的类是否添加了Spring Bean注解，比如@Component、@Service、@Repository或自定义的@Component派生注解：

package com.xxx.module1;

import com.xxx.common.ABC;
import org.springframework.stereotype.Component;

@Component
public class ABCModule1Impl implements ABC {
    // 实现逻辑
}

未添加此类注解的类不会被Spring识别为Bean。

3. 排查Bean扫描的过滤规则 #

检查项目中是否存在自定义的@ComponentScan.Filter配置，或Spring Boot自动配置的过滤规则，导致module1下的类被排除：

@SpringBootApplication(
    scanBasePackages = {"com.xxx"},
    excludeFilters = @ComponentScan.Filter(type = FilterType.REGEX, pattern = "com.xxx.module1.*")
)

这类过滤配置会直接跳过module1的Bean扫描流程。

4. 检查模块打包与依赖传递 #

• 若module1为pom打包方式，确认其依赖是否正确传递给module2；
• 若为jar打包，确认module1的jar包是否已正确构建并被module2引用。可通过IDE的依赖分析工具查看module2是否实际引入了module1的编译产物。

5. 查看Spring组件扫描日志 #

开启Spring组件扫描的DEBUG日志，直观排查扫描过程：
在application.properties中添加：

logging.level.org.springframework.context.annotation=DEBUG

启动项目后，搜索Candidate component class found相关日志，查看是否出现module1中Bean的类名。若未出现，说明类未被扫描到；若出现但未被注册，可能存在Bean名称冲突或其他注册异常。

内容的提问来源于stack exchange，提问作者Alfred joseph