Spring Boot多模块集成测试：模块内测试无法加载组件

嘿，我太懂你这种糟心的情况了——多模块Maven项目里，明明把集成测试放在对应模块里，结果用@RunWith(SpringRunner.class)跑测试时，Spring死活找不到组件，报错一堆，简直头大。我来给你捋几个最实用的解决办法，应该能帮你搞定：

本质上是因为每个Maven模块是独立构建单元，Spring默认的组件扫描范围有限，要么没覆盖到当前模块的组件包，要么没包含依赖模块的组件路径，导致容器初始化时找不到需要的Bean。

1. 给测试类精准配置组件扫描 #

如果是Spring Boot项目，别光靠默认扫描，手动指定模块的主启动类才是稳的：

@SpringBootTest(classes = YourModuleMainApplication.class)
@RunWith(SpringRunner.class)
public class YourModuleIntegrationTest {
    // 你的测试代码
}

如果是普通Spring项目，直接用@ComponentScan把所有需要的组件包列出来：

@ContextConfiguration
@ComponentScan(basePackages = {
    "com.yourcompany.yourmodule.service",
    "com.yourcompany.dependencymodule.repository"
})
@RunWith(SpringRunner.class)
public class YourIntegrationTest {
    // 测试代码
}

划重点：把当前模块和依赖模块的组件包都加进去，别漏了！

2. 检查Maven模块的依赖关系 #

确保当前模块的pom.xml已经正确引入了所有需要的依赖模块。比如你的模块依赖另一个模块的JPA组件，就得这么加：

<dependency>
    <groupId>com.yourcompany</groupId>
    <artifactId>dependency-module</artifactId>
    <version>${project.version}</version>
    <!-- 集成测试一般用compile或runtime scope，别乱加test -->
</dependency>

另外，spring-test、junit这些测试基础依赖也得确认有没有引入，别漏了核心依赖。

3. Web模块测试要指定Web环境 #

如果你的模块是Web相关（比如webapp入口模块），记得给@SpringBootTest加webEnvironment参数，让Spring启动嵌入式服务器加载Web组件：

@SpringBootTest(
    classes = YourWebAppApplication.class,
    webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT
)
@RunWith(SpringRunner.class)
public class WebIntegrationTest {
    // 测试代码
}

4. 模块主配置类要“到位” #

• Spring Boot模块的主启动类尽量放在模块的根包下（比如com.yourcompany.yourmodule.YourModuleApplication），这样默认扫描能覆盖所有子包的组件。如果组件在非子包，主类上要加@ComponentScan指定那些包。
• 非Spring Boot模块的话，测试类里的@ContextConfiguration要指定正确的配置类或者XML配置文件，别让Spring瞎找。

5. 测试类包结构尽量对齐被测试组件 #

尽量让测试类和被测试的Service/Controller/Repository在同包或者子包下，比如被测试的Service在com.yourcompany.yourmodule.service，测试类就放在com.yourcompany.yourmodule.service.test或者直接同包下，这样Spring默认扫描就能覆盖到，省得额外配置。

6. JPA模块测试要额外配置扫描 #

如果测试涉及JPA，光靠组件扫描还不够，得加上@EnableJpaRepositories和@EntityScan指定Repository和实体类的路径：

@SpringBootTest(classes = YourJpaModuleApplication.class)
@EnableJpaRepositories(basePackages = "com.yourcompany.yourmodule.repository")
@EntityScan(basePackages = "com.yourcompany.yourmodule.entity")
@RunWith(SpringRunner.class)
public class JpaIntegrationTest {
    // 测试代码
}

不然Spring找不到Repository和实体类，肯定报错。

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