Spring Boot多模块项目跨模块注入@Component组件的方法

问题描述 #

我有一个父级Java项目，包含两个Spring Boot子模块，父pom.xml配置如下：

<modules>
    <module>module1</module>
    <module>module2</module>
</modules>

想了解如何在不同模块间自动装配组件：module1的包路径为com.abc.app1.module1，module2的包路径为com.abc.app1.module2，其中module2的com.abc.app1.module2.services包下有一个标注了@Component的UserDetailService类，如何在module1的类中自动装配该UserDetailService？直接使用如下代码是否可行？

@Autowired
UserDetailService userDetailService

另外我之前只做过单模块项目，对ComponentScan存在疑问：是否需要配置ComponentScan？若需要，应该在哪里配置？

核心问题解答 #

1. 直接使用@Autowired是否可行？ #

直接这么写不可行，原因有两点：

• 编译层面：module1的代码要引用module2的类，必须先在module1的pom.xml中添加对module2的依赖，否则编译阶段会报错找不到UserDetailService类。
• Spring容器层面：Spring Boot默认组件扫描范围是启动类所在包及其子包。如果module1的启动类在com.abc.app1.module1下，默认只会扫描该包及其子包的组件，不会覆盖module2的com.abc.app1.module2包，因此UserDetailService不会被Spring容器管理，自然无法注入。

2. 是否需要配置ComponentScan？该如何配置？ #

需要配置，推荐两种实用方案：

方案一：调整启动类位置（推荐，符合约定大于配置原则）

将两个模块的启动类都移到共同的父包com.abc.app1下：

• module1启动类放在com.abc.app1.Module1Application
• module2启动类放在com.abc.app1.Module2Application

这样Spring Boot默认的组件扫描会自动覆盖com.abc.app1下的所有子包（包括module1和module2的包），无需额外配置@ComponentScan。

方案二：显式配置@ComponentScan

如果不想调整启动类位置，可以在module1的启动类上添加@ComponentScan注解，指定要扫描的module2包路径：

@SpringBootApplication
@ComponentScan(basePackages = {"com.abc.app1.module1", "com.abc.app1.module2"})
public class Module1Application {
    public static void main(String[] args) {
        SpringApplication.run(Module1Application.class, args);
    }
}

也可以直接指定目标类所在包，写法更灵活：

@SpringBootApplication
@ComponentScan(basePackageClasses = UserDetailService.class)
public class Module1Application {
    // ...
}

额外注意事项 #

• 确认module2的UserDetailService确实标注了@Component或其派生注解（如@Service），否则Spring无法识别它为可管理组件。
• 多模块依赖时，需先执行mvn install将module2打包到本地仓库，确保module1能正常引入依赖。

内容的提问来源于stack exchange，提问作者Alok Kumar