在 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<customer> result = customers.findByLastName("Bauer");
// 断言
assertThat(result).hasSize(1);
assertThat(result.get(0).getFirstName()).isEqualTo("Jack");
}
}</customer>
? 为什么这样有效？
将 Spring Boot 2.7 项目升级到 Spring Boot 3.5 的实战流程，覆盖版本基线、依赖坐标替换、Jakarta 迁移、配置兼容、异步上下文传递改造与验证门禁。用于企业多模块 Maven 项目升级与排障。
- @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 场景。
