JUnit5+H2内存库测试时ApplicationContext加载失败问题求助

问题背景 #

• 技术栈：Spring Boot + JUnit + AssertJ，配置H2内存数据库
• 核心错误：运行LehrerRepositoryTest时抛出java.lang.IllegalStateException: Failed to load ApplicationContext，根因是无法获取@EnableAutoConfiguration的基础包
• 已尝试无效操作：调整pom.xml依赖scope、修改配置文件名为application-test.properties、添加@EntityScan/@EnableJpaRepositories注解、尝试@SpringBootTest但触发@BootstrapWith重复声明错误
• 额外现象：单独使用@SpringBootTest可成功加载上下文，Hibernate执行drop table user语句时出现警告

排查与解决方案 #

1. 修正测试类包路径匹配问题 #

Spring Boot自动配置默认扫描主应用类所在包及其子包，如果测试类的包路径与主应用类（如VertretungsplanApplication）的包路径不重叠，@EnableAutoConfiguration无法识别基础包。

• 操作：将LehrerRepositoryTest移至与主应用类同层级或子层级的包下（例如主应用在de.gabriel.vertretungsplan，测试类放到de.gabriel.vertretungsplan.repository）

2. 规范Repository测试的注解使用 #

@DataJpaTest本身已包含JPA相关自动配置逻辑，与@SpringBootTest混用会导致@BootstrapWith重复声明。正确的Repository测试注解组合如下：

@DataJpaTest
@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE) // 复用自定义H2配置
@EntityScan(basePackages = "de.gabriel.vertretungsplan.models") // 指定实体类所在包
@EnableJpaRepositories(basePackages = "de.gabriel.vertretungsplan.repository") // 指定Repository所在包
class LehrerRepositoryTest {

    @Autowired
    private LehrerRepository lehrerRepository;

    // 测试用例实现...
}

3. 解决Hibernate表名关键字冲突警告 #

drop table user的警告是因为user是H2数据库的关键字，需修改实体类的表名映射：

• 在对应实体类的@Table注解中添加反引号转义：

  @Entity
  @Table(name = "`user`")
  public class User {
      // 实体字段...
  }
  

• 或直接重命名表名（如改为app_user）避免关键字冲突

4. 验证测试环境配置 #

确保application-test.properties中的H2配置正确：

spring.datasource.url=jdbc:h2:mem:testdb
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=
spring.jpa.database-platform=org.hibernate.dialect.H2Dialect
spring.jpa.hibernate.ddl-auto=create-drop

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