Spring Boot多模块测试中JPA无法找到Mock模块实体表的问题

我来帮你分析下这个问题，这其实是Spring Boot多模块测试中常见的实体扫描范围、依赖作用域和JPA配置组合导致的问题，咱们一步步来解决：

问题根源拆解 #

从报错堆栈能看出，核心问题是EntityManagerFactory初始化失败，Hibernate无法构建SessionFactory——因为你设置了spring.jpa.hibernate.ddl-auto: validate，Hibernate会校验所有已扫描到的@Entity类对应的数据库表是否存在，但主模块的测试上下文没有扫描到Mock子模块的@Entity类，导致主模块启动时没创建这些表，而测试中用到Mock实体时，Hibernate校验表存在性就失败了。

另外，Mock模块是test scope依赖，这意味着它的类只会在测试阶段被加载，但Spring Boot默认的实体扫描范围是主模块的包路径，不会自动扩展到test依赖的子模块。

具体解决方案 #

1. 让测试上下文扫描Mock模块的实体类 #

在你的测试类（或测试专用配置类）上添加@EntityScan注解，明确指定主模块和Mock模块的实体包路径，确保Spring能扫描到所有需要的@Entity：

import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.autoconfigure.domain.EntityScan;
import org.junit.Test;

@SpringBootTest
@EntityScan(basePackages = {"com.yourmain.module.entity", "com.yourmock.module.entity"})
public class YourMainModuleTest {
    // 测试代码
}

或者创建一个测试专用的配置类：

import org.springframework.boot.autoconfigure.domain.EntityScan;
import org.springframework.context.annotation.Configuration;

@Configuration
@EntityScan(basePackages = {"com.yourmain.module.entity", "com.yourmock.module.entity"})
public class TestJpaConfig {
}

然后在测试类中导入这个配置：

@SpringBootTest
@Import(TestJpaConfig.class)
public class YourMainModuleTest {
    // 测试代码
}

2. 调整JPA的DDL配置适配测试场景 #

既然Mock模块仅用于本地测试，你可以在测试环境的配置文件（比如src/test/resources/application-test.properties）中修改DDL策略，让Hibernate自动创建Mock模块的表，而不是严格校验：

# 测试环境用create-drop或update，避免validate导致的表不存在报错
spring.jpa.hibernate.ddl-auto=create-drop

create-drop会在测试启动时创建表，测试结束后删除，非常适合临时的测试场景；如果需要保留表结构，也可以用update。

3. 确保Mock模块的依赖能被测试上下文访问 #

检查Mock模块的pom.xml，确保JPA相关的依赖（比如spring-boot-starter-data-jpa）是compile作用域，而不是test，否则主模块的测试类可能无法加载Mock模块的@Entity类：

<!-- Mock模块pom.xml -->
<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
        <!-- 不要设为test scope，否则主模块测试时无法加载实体类 -->
        <scope>compile</scope>
    </dependency>
</dependencies>

主模块对Mock模块的依赖保持test scope即可：

<!-- 主模块pom.xml -->
<dependencies>
    <dependency>
        <groupId>com.yourgroup</groupId>
        <artifactId>mock-module</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

4. 分离测试上下文与主应用上下文 #

如果你的测试不需要加载主应用的完整上下文，可以专门为Mock相关测试创建独立的测试配置，只加载Mock模块和必要的JPA配置，避免主模块的配置干扰：

import org.springframework.boot.autoconfigure.orm.jpa.HibernateJpaAutoConfiguration;
import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Import;
import org.springframework.boot.autoconfigure.domain.EntityScan;

@Configuration
@Import({DataSourceAutoConfiguration.class, HibernateJpaAutoConfiguration.class})
@EntityScan("com.yourmock.module.entity")
public class MockOnlyTestConfig {
}

然后在测试类中使用这个配置：

@ContextConfiguration(classes = MockOnlyTestConfig.class)
public class MockModuleTest {
    // 仅测试Mock模块的代码
}

验证方案 #

按照以上步骤调整后，重新运行测试：

1. 测试上下文会扫描到Mock模块的@Entity类
2. Hibernate会根据DDL策略自动创建对应的表（或校验存在）
3. 实体管理器能正常初始化，ApplicationContext加载成功

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