如何在 Spring Boot 3 环境下为纯 JPA 库编写正确的集成测试

在 spring boot 3 中测试无 `@springbootapplication` 的独立 jpa 库时，应使用 `@datajpatest` 并嵌套一个空的 `@springbootapplication` 配置类，以触发 spring boot 自动配置机制，从而正确加载 repository 和 `testentitymanager`。

当你的项目是一个纯库（library）而非可执行应用时，主模

块中通常不包含 @SpringBootApplication 类——这是合理的设计，但会给集成测试带来挑战：@DataJpaTest 默认依赖 Spring Boot 的自动配置上下文引导，而该引导需要至少一个被 @SpringBootApplication 或等效元注解标记的配置源。若完全移除启动类，@DataJpaTest 将因无法推导配置来源而失败（表现为 NoSuchBeanDefinitionException、NullPointerException 或 IllegalStateException: found multiple declarations of @BootstrapWith 等错误）。

✅ 正确解法是：在测试类内部定义一个静态嵌套的 @SpringBootApplication 配置类。它不需任何逻辑，仅作为 Spring Boot 测试上下文的“锚点”，使 @DataJpaTest 能识别并启用完整的 JPA 自动配置（包括 DataSource、EntityManagerFactory、TestEntityManager 及所有 @Repository Bean）。

以下是推荐的完整测试结构：

@ExtendWith(SpringExtension.class)
@DataJpaTest
public class CustomerRepositoryTests {

    // ✅ 关键：提供 Spring Boot 上下文入口点
    @SpringBootApplication
    static class TestConfig {}

    @Autowired
    private TestEntityManager entityManager;

    @Autowired
    private CustomerRepository customers;

    @Test
    void testFindByLastName() {
        // 准备测试数据（使用 TestEntityManager 确保 flush 到 DB）
        Customer customer = new Customer("Jack", "Bauer");
        entityManager.persistAndFlush(customer);

        // 执行查询
        List result = customers.findByLastName("Bauer");

        // 断言
        assertThat(result).hasSize(1);
        assertThat(result.get(0).getFirstName()).isEqualTo("Jack");
    }
}

? 为什么这样有效？

• @DataJpaTest 本身是切片测试注解，默认仅加载 JPA 相关的自动配置，并禁用完整上下文。但它仍需一个“配置来源”来推断包扫描路径和基础环境。嵌套的 @SpringBootApplication 恰好满足这一要求，且因其位于测试类内，不会污染主代码或影响其他模块。
• Spring Boot 3+ 完全支持此模式（参考 spring-data-examples/jpa/showcase 的实践）。
• ❌ 不要混用 @DataJpaTest 与 @SpringBootTest ——二者底层使用不同的 ContextBootstrapper，会导致 @BootstrapWith 冲突异常。

⚠️ 注意事项：

• 若 Repository 依赖自定义 @Configuration 或特定 @EntityScan 路径，请在 TestConfig 类上显式声明：

  @SpringBootApplication
  @EntityScan("com.example.yourpackage.entity")
  static class TestConfig {}

• 确保测试依赖中包含 spring-boot-starter-test（含 spring-test, spring-boot-test-autoconfigure, h2 等），H2 内存数据库会由 @DataJpaTest 自动配置。
• 如需覆盖测试属性（如数据库 URL），可通过 @DataJpaTest(properties = "spring.datasource.url=jdbc:h2:mem:testdb") 指定。

总结：对于 Spring Boot 3 的 JPA 库测试，@DataJpaTest + 嵌套@SpringBootApplication` 是简洁、标准且可靠的最佳实践——它最小化配置负担，精准激活所需基础设施，完美适配 library 场景。