Spring Boot Data JPA项目ApplicationContext创建失败求助

针对@DataJpaTest+Testcontainers的配置排查 #

• 核对Testcontainers依赖是否正确引入，Maven项目需确保pom.xml包含以下依赖（版本匹配Spring Boot版本）：

  <dependency>
      <groupId>org.testcontainers</groupId>
      <artifactId>postgresql</artifactId>
      <scope>test</scope>
  </dependency>
  <dependency>
      <groupId>org.testcontainers</groupId>
      <artifactId>junit-jupiter</artifactId>
      <scope>test</scope>
  </dependency>
  

• 检查测试类的容器配置是否规范：必须用@Container声明静态PostgreSQL容器实例，并通过@DynamicPropertySource动态注入连接参数，不能硬编码localhost地址：

  @DataJpaTest
  class UserRepositoryTest {
      @Container
      static PostgreSQLContainer<?> postgresContainer = new PostgreSQLContainer<>("postgres:15-alpine");
  
      @DynamicPropertySource
      static void setDbProperties(DynamicPropertyRegistry registry) {
          registry.add("spring.datasource.url", postgresContainer::getJdbcUrl);
          registry.add("spring.datasource.username", postgresContainer::getUsername);
          registry.add("spring.datasource.password", postgresContainer::getPassword);
      }
  
      // 测试逻辑代码
  }
  

• 确认application-test.properties中没有硬编码的PostgreSQL连接配置，否则会覆盖Testcontainers动态注入的参数，导致依然尝试连接本地5432端口。

针对H2内存数据库的配置排查 #

• 确认H2依赖已引入（测试环境生效）：

  <dependency>
      <groupId>com.h2database</groupId>
      <artifactId>h2</artifactId>
      <scope>test</scope>
  </dependency>
  

• 检查application-test.properties的H2配置是否正确：

  spring.datasource.url=jdbc:h2:mem:testdb;DB_CLOSE_DELAY=-1
  spring.datasource.driver-class-name=org.h2.Driver
  spring.datasource.username=sa
  spring.datasource.password=
  spring.jpa.database-platform=org.hibernate.dialect.H2Dialect
  

• 测试类需添加@ActiveProfiles("test")注解，确保加载测试环境的H2配置，而非主环境的PostgreSQL配置。

通用排查点 #

• 检查主配置文件（application.properties/yml）是否存在硬编码的PostgreSQL连接信息，@DataJpaTest默认会继承主配置的部分属性，若未被测试配置完全覆盖，仍会尝试连接本地数据库。
• 查看测试日志的完整堆栈信息，确认是否存在隐藏异常：比如实体类注解错误、JpaRepository定义不规范等，可能表面表现为连接失败，实际是上下文加载的其他问题。
• 核对IDE测试运行配置：是否激活了正确的profile，是否传入了覆盖数据源配置的系统参数。

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