PostgreSQL 无法连接到测试容器 Postgres 实例

在本文中，我们将介绍如何使用测试容器（testcontainer）创建和管理 PostgreSQL 实例，并解决无法连接到测试容器 Postgres 实例的问题。

什么是测试容器

测试容器（Testcontainers）是一个用于快速、可靠地启动、管理和停止容器的 Java 库。它旨在帮助开发人员在测试环境中使用容器化的应用程序。

使用测试容器创建和管理 PostgreSQL 实例

在开始之前，请确保已安装 Docker 和相应的依赖。

首先，我们需要添加 Maven 依赖，以在项目中使用测试容器库。在 pom.xml 文件中添加以下依赖项：

<dependency>
    <groupId>org.testcontainers</groupId>
    <artifactId>testcontainers</artifactId>
    <version>1.16.0</version>
    <scope>test</scope>
</dependency>

接下来，我们创建一个测试类，并在类级别上添加以下注解：

@Testcontainers
public class PostgreSQLContainerIntegrationTest {

    @Container
    public PostgreSQLContainer<?> postgreSQLContainer = new PostgreSQLContainer<>("postgres:13.2")
            .withDatabaseName("test")
            .withUsername("test")
            .withPassword("test");

    // ... more tests
}

在上面的代码中，我们使用 PostgreSQLContainer 创建了一个 PostgreSQL 实例，并指定了数据库名称、用户名和密码。

现在，我们可以编写测试方法来验证我们是否能够成功连接到测试容器 Postgres 实例。以下是一个示例：

@Test
public void testConnectionToPostgresContainer() throws SQLException {
    String jdbcUrl = postgreSQLContainer.getJdbcUrl();
    String username = postgreSQLContainer.getUsername();
    String password = postgreSQLContainer.getPassword();

    Connection connection = DriverManager.getConnection(jdbcUrl, username, password);
    assertTrue(connection.isValid(5));
}

在上面的测试方法中，我们使用测试容器提供的连接信息来创建一个 JDBC 连接，并验证连接是否有效。

解决无法连接到测试容器 Postgres 实例的问题

当我们尝试连接到测试容器 Postgres 实例时，可能会遇到一些问题。下面列出了一些常见问题及其解决方法：

1. 容器启动时间太长

在启动测试容器时，可能会由于网络或硬件等原因导致容器启动时间较长。可以通过增加启动超时时间来解决此问题。

public PostgreSQLContainer<?> postgreSQLContainer = new PostgreSQLContainer<>("postgres:13.2")
            .withStartupTimeout(Duration.ofMinutes(5));

在上面的示例中，我们将容器的启动超时时间设置为 5 分钟。

2. 端口冲突

测试容器会自动选择一个未使用的端口启动 PostgreSQL 实例。如果端口冲突，可以使用以下方法来解决：

public PostgreSQLContainer<?> postgreSQLContainer = new PostgreSQLContainer<>("postgres:13.2")
            .withExposedPorts(5432);

在上面的示例中，我们将 PostgreSQL 容器映射到主机的 5432 端口。

3. 数据库名称、用户名或密码不正确

确保在创建 PostgreSQL 容器时，指定的数据库名称、用户名和密码与连接测试时使用的信息一致。

总结

本文介绍了如何使用测试容器创建和管理 PostgreSQL 实例，并解决无法连接到测试容器 Postgres 实例的问题。测试容器是一个强大的工具，可以帮助开发人员快速搭建测试环境，并进行容器化应用程序的集成测试。使用测试容器，我们可以轻松地创建和销毁容器，并获得准确的测试结果。希望本文对你在使用测试容器管理 PostgreSQL 实例时有所帮助。