Spring Boot集成测试：调试时连接Testcontainer数据库问题

在Spring Boot集成测试中使用Testcontainer连接Docker编排的数据库时遇到以下问题：

• 配置文件中指定的数据库连接信息：

spring:
  datasource:
    driver-class-name: org.testcontainers.jdbc.ContainerDatabaseDriver
    url: jdbc:tc:postgresql:14.6-alpine:///employees_db
    username: sa
    password: 123456

• 调试测试时，控制台输出的实际连接URL为：

Database: jdbc:postgresql://localhost:64880/test (PostgreSQL 14.6)

• 使用上述两个URL通过DBeaver连接时，均出现认证失败或连接拒绝错误，需解决如何在测试断点暂停时连接该数据库。

1. 搞懂Testcontainer的JDBC URL机制 #

你配置的jdbc:tc:postgresql:14.6-alpine:///employees_db是Testcontainer的特殊JDBC格式，它会自动创建并管理PostgreSQL容器，但默认会用test数据库、test用户名和空密码——这就是控制台显示test数据库的原因，和你配置的sa/123456完全不匹配，自然连不上。

2. 修正配置，指定自定义凭据和数据库 #

修改测试专用配置文件（比如application-test.yml），添加Testcontainer初始化参数，强制指定你需要的数据库名、用户名和密码：

spring:
  datasource:
    driver-class-name: org.testcontainers.jdbc.ContainerDatabaseDriver
    url: jdbc:tc:postgresql:14.6-alpine:///employees_db?TC_DATABASE=employees_db&TC_USERNAME=sa&TC_PASSWORD=123456
    username: sa
    password: 123456

说明：TC_DATABASE指定容器启动时创建的数据库名，TC_USERNAME和TC_PASSWORD设置数据库的登录凭据，这样Testcontainer会按你的配置初始化容器。

3. 直接通过Testcontainer实例获取连接信息（更靠谱） #

放弃JDBC URL自动管理的方式，直接在测试代码中声明容器，手动绑定配置，调试时能直接拿到准确的连接参数：

@SpringBootTest
@Testcontainers
public class EmployeeRepositoryTest {

    @Container
    private static PostgreSQLContainer<?> postgresContainer = new PostgreSQLContainer<>("postgres:14.6-alpine")
            .withDatabaseName("employees_db")
            .withUsername("sa")
            .withPassword("123456");

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

    // 调试时在这里加断点，打印容器的真实连接信息
    @Test
    void testDatabaseConnection() {
        System.out.println("实际JDBC URL: " + postgresContainer.getJdbcUrl());
        System.out.println("用户名: " + postgresContainer.getUsername());
        System.out.println("密码: " + postgresContainer.getPassword());
        // 执行测试逻辑
    }
}

4. 断点时连接数据库的操作步骤 #

当测试停在断点时：

1. 从控制台或测试代码的打印内容中，拿到真实的JDBC URL（比如jdbc:postgresql://localhost:64880/employees_db）、用户名sa、密码123456。
2. 打开DBeaver新建PostgreSQL连接：
   • 主机填localhost
   • 端口填控制台显示的随机端口（比如64880）
   • 数据库名填employees_db
   • 用户名和密码分别填sa和123456
3. 点击测试连接，此时容器处于运行状态，就能成功连接。

5. 排查连接拒绝的常见原因 #

• 确认断点暂停时，Testcontainer的PostgreSQL容器没被销毁（默认测试方法执行完才会销毁，断点时容器是活的）。
• 检查本地防火墙是否拦截了该随机端口的访问。
• 确保DBeaver的PostgreSQL驱动版本和容器中的14.6版本兼容。

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