Spring Modulith多模块下ApplicationModuleTest的JPA仓库加载异常问题

问题场景 #

项目基于Spring Modulith构建多模块应用，结构如下：

• 根包：nl.daniel.dejong，包含主类Application.java
• 子模块：inventorymanagement、orderfulfillment，每个模块拆分domain和infrastructure.persistence层，JPA仓库继承JpaRepository
• 主类Application标注@EnableJpaRepositories但未指定扫描范围
• 测试inventorymanagement模块时，测试类ProductIntegrationTest标注@ApplicationModuleTest，此时Spring尝试创建orderfulfillment模块的OutboundOrderJpaPersistence Bean，但因测试范围过滤，找不到对应的OutboundOrder实体类，最终导致ApplicationContext加载失败。

原因剖析 #

• @EnableJpaRepositories默认会扫描主类所在包及其所有子包，也就是全局扫描整个项目的JPA仓库，包括orderfulfillment模块的仓库类。
• @ApplicationModuleTest的核心作用是仅加载目标模块及其依赖模块的Bean，会自动过滤掉非目标模块的类（比如orderfulfillment的实体类不会被纳入测试上下文）。
• 两者的冲突导致：全局扫描到的orderfulfillment仓库Bean，在测试上下文里找不到对应的实体类，最终初始化失败。

正确解决方案 #

方案1：按模块拆分JPA仓库配置（推荐） #

移除根主类Application上的@EnableJpaRepositories，在每个模块的基础设施层单独创建配置类，指定该模块的仓库扫描范围：

比如在inventorymanagement/infrastructure/persistence下创建配置类：

@Configuration
@EnableJpaRepositories(basePackages = "nl.daniel.dejong.inventorymanagement.infrastructure.persistence")
public class InventoryPersistenceConfiguration {
}

同理在orderfulfillment/infrastructure/persistence下创建对应配置类：

@Configuration
@EnableJpaRepositories(basePackages = "nl.daniel.dejong.orderfulfillment.infrastructure.persistence")
public class OrderFulfillmentPersistenceConfiguration {
}

这样@ApplicationModuleTest测试inventorymanagement模块时，只会加载该模块的配置类，不会扫描到orderfulfillment的仓库Bean，从根源避免冲突。

方案2：测试类中覆盖JPA扫描范围 #

如果不想修改主配置，可以在测试类上添加@EnableJpaRepositories，指定仅扫描当前测试模块的仓库路径，覆盖主类的全局配置：

@ApplicationModuleTest
@EnableJpaRepositories(basePackages = "nl.daniel.dejong.inventorymanagement.infrastructure.persistence")
public class ProductIntegrationTest {
    // 测试逻辑
}

这种方式适合临时场景，但每个测试类都需要重复配置，不如方案1优雅。

是否为预期行为？ #

这是预期行为。Spring Modulith的核心设计是维护模块边界的独立性，测试时仅加载必要的模块内容。而@EnableJpaRepositories未指定范围的全局扫描，本身就违反了模块隔离的原则。Spring Modulith不会自动修改Spring Data JPA的扫描配置，因为这属于Spring Data的职责范畴，Modulith只负责模块边界的管理和测试范围的过滤。

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