SpringBoot测试中JpaRepository连接本地库而非Docker容器库问题

核心问题 #

你的测试代码中，用于动态配置数据源的setProperties方法未被Spring识别执行，导致应用依然使用本地数据库配置（比如application.properties里的localhost:5432），所以测试时会连接本地PostgreSQL，关闭本地服务就触发连接拒绝错误。

修复步骤 #

1. 给setProperties方法添加@DynamicPropertySource注解，这是Testcontainers与SpringBoot集成的核心注解，用于动态覆盖数据源配置：

@DynamicPropertySource
static void setProperties(DynamicPropertyRegistry dynamicPropertyRegistry) {
    dynamicPropertyRegistry.add("spring.datasource.url", postgreSQLContainer::getJdbcUrl);
    dynamicPropertyRegistry.add("spring.datasource.username", postgreSQLContainer::getUsername);
    dynamicPropertyRegistry.add("spring.datasource.password", postgreSQLContainer::getPassword);
}

2. 确认测试依赖完整（以Maven为例），需引入Testcontainers的PostgreSQL和JUnit Jupiter支持：

<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>

3. 验证SpringBoot与Testcontainers版本兼容，比如SpringBoot 2.7.x对应Testcontainers 1.17.x及以上版本，版本不匹配可能导致注解失效。

额外检查项 #

• 确保@Container修饰的容器实例为static类型（你的代码已满足），这是Testcontainers维持容器生命周期的要求。
• 若存在application-test.properties，检查其中是否有硬编码的数据源配置，避免覆盖动态注入的容器数据库配置。

修复后，测试会自动启动PostgreSQL容器，并将Spring数据源指向容器内的数据库，关闭本地PostgreSQL服务后不会再出现连接拒绝错误，Assertions.assertTrue(productRepository.findAll().size() == 1)断言也会正常通过。

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