如何为两个PostgreSQL测试容器配置不同本地端口映射？

API 探路者

2026-7-27

解决PostgreSQL测试容器端口冲突问题

你可以通过Testcontainers提供的端口绑定API来修改其中一个容器的本地映射端口，以下是两种常用方案：

方案一：指定固定本地端口

直接给其中一个容器绑定自定义本地端口，比如将第二个容器映射到本地5433端口：

@Container
private static final PostgreSQLContainer<?> postgresql1 = new PostgreSQLContainer<>("postgres:latest")
        .withDatabaseName("testdb1")
        .withUsername("testuser1")
        .withPassword("testpass1");

@Container
private static final PostgreSQLContainer<?> postgresql2 = new PostgreSQLContainer<>("postgres:latest")
        .withDatabaseName("testdb2")
        .withUsername("testuser2")
        .withPassword("testpass2")
        .withPortBindings(new PortBinding(Ports.Binding.bindPort(5433), new ExposedPort(5432)));

这里bindPort(5433)指定本地要映射的端口，ExposedPort(5432)对应容器内部PostgreSQL的默认服务端口。

方案二：使用随机分配端口（推荐）

如果不需要固定端口，Testcontainers会自动分配本地可用的随机端口，彻底避免冲突，之后通过容器对象动态获取实际映射的端口即可：

@Container
private static final PostgreSQLContainer<?> postgresql1 = new PostgreSQLContainer<>("postgres:latest")
        .withDatabaseName("testdb1")
        .withUsername("testuser1")
        .withPassword("testpass1");

@Container
private static final PostgreSQLContainer<?> postgresql2 = new PostgreSQLContainer<>("postgres:latest")
        .withDatabaseName("testdb2")
        .withUsername("testuser2")
        .withPassword("testpass2");

// 获取实际映射端口的示例代码
int db1Port = postgresql1.getFirstMappedPort();
int db2Port = postgresql2.getFirstMappedPort();

这种方式更灵活，尤其适合CI环境或本地同时运行多个服务的场景，无需担心端口占用问题。