为何标注@DataJpaTest的单元测试仍会加载@SpringBootApplication主类的全部配置？

安全阿岳

2026-9-29

问题原因

核心原因是@DataJpaTest默认会向上扫描查找最近的标注了@SpringBootApplication的类作为配置源，你项目的主启动类上不仅配置了全量包扫描路径，还额外加了@EnableCaching、@EnableAsync等全局启用注解，这些注解会触发对应组件的自动加载，导致拦截器、缓存等无关Bean全部被初始化。
如果你项目引入了Spring Cloud相关依赖，测试默认会加载Bootstrap上下文，因此会自动读取bootstrap.properties配置文件，这属于Spring Cloud的默认行为，和@DataJpaTest本身的配置无关。

解决方案

以下方案按推荐优先级排序：

测试使用独立最小配置类（最推荐）
在测试代码目录下创建仅适配JPA测试的专用配置类，不要复用主启动类的全量配置：

// 测试配置类，仅配置JPA必要的扫描路径
@SpringBootApplication(scanBasePackages = "com.mycompany.sample.users")
@EntityScan(basePackages = "com.mycompany.sample.users.entity")
@EnableJpaRepositories(basePackages = "com.mycompany.sample.users.repository")
public class JpaTestConfig {
}

修改测试类，指定使用该配置类，同时禁用Bootstrap上下文加载：

@DataJpaTest
@ContextConfiguration(classes = JpaTestConfig.class)
@TestPropertySource(properties = "spring.cloud.bootstrap.enabled=false")
public class UsersRepositoryTest {
    // 原有测试逻辑不变
}

直接在测试注解上过滤无关组件
如果不想新增配置类，可通过@DataJpaTest的过滤规则仅加载需要的Bean，同时排除主启动类的配置：

@DataJpaTest(
    useDefaultFilters = false,
    includeFilters = {
        @ComponentScan.Filter(type = FilterType.ASSIGNABLE_TYPE, value = UsersRepository.class),
        @ComponentScan.Filter(type = FilterType.ASSIGNABLE_TYPE, value = User.class)
    }
)
@TestPropertySource(properties = "spring.cloud.bootstrap.enabled=false")
public class UsersRepositoryTest {
    // 原有测试逻辑不变
}

调整测试类包结构
将JPA测试类放到和主启动类无关的独立包路径下，避免@DataJpaTest自动扫描到主启动类，该方案改动较大，优先级最低。

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