Spring Boot 3.1集成Compose与PostgreSQL时contextLoad测试失败

问题原因 #

你的项目依赖了Data JPA，执行测试时Spring Boot会尝试自动配置数据源，但测试环境下要么Docker Compose的PostgreSQL服务未被正确触发启动，要么测试类未加载到有效的数据库连接配置，最终导致驱动类无法被识别。

解决方案 #

方案1：让测试环境正确复用Docker Compose的PostgreSQL服务 #

1. 确保测试类添加@SpringBootTest注解，Spring Boot 3.1+会自动识别项目根目录的compose.yml并启动对应服务：

@SpringBootTest
class DemoApplicationTests {

    @Test
    void contextLoads() {
    }
}

2. 若需手动指定测试环境的数据库配置，在src/test/resources/application-test.properties中补充：

# 若Docker Compose已配置数据库信息，以下配置可省略；需自定义时添加
spring.datasource.url=jdbc:postgresql://localhost:5432/your-db-name
spring.datasource.username=your-db-username
spring.datasource.password=your-db-password
spring.datasource.driver-class-name=org.postgresql.Driver

注意：确保compose.yml中的PostgreSQL端口映射与配置一致。

方案2：排除数据源自动配置（仅适用于无需数据库的基础上下文测试） #

如果contextLoads()仅用于验证Spring上下文能否正常加载，不需要数据库支持，可以直接排除数据源相关的自动配置类：

@SpringBootTest(exclude = {
    DataSourceAutoConfiguration.class,
    DataSourceTransactionManagerAutoConfiguration.class,
    HibernateJpaAutoConfiguration.class
})
class DemoApplicationTests {

    @Test
    void contextLoads() {
    }
}

此方式会跳过数据源初始化流程，直接避免驱动类找不到的错误。

方案3：用Testcontainers单独配置测试数据库 #

如果需要更灵活的测试数据库控制，可以直接通过Testcontainers启动独立的PostgreSQL容器：

@SpringBootTest
@Testcontainers
class DemoApplicationTests {

    @Container
    static PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:15-alpine")
            .withDatabaseName("test-db")
            .withUsername("test-user")
            .withPassword("test-pass");

    @DynamicPropertySource
    static void configureProperties(DynamicPropertyRegistry registry) {
        registry.add("spring.datasource.url", postgres::getJdbcUrl);
        registry.add("spring.datasource.username", postgres::getUsername);
        registry.add("spring.datasource.password", postgres::getPassword);
    }

    @Test
    void contextLoads() {
    }
}

这种方式无需依赖项目的compose.yml，会在测试时自动创建并销毁独立的数据库容器，适合隔离性要求高的测试场景。

内容的提问来源于stack exchange，提问作者Ali Behzadian Nejad