拆分测试类引发PSQLException：连接失败/地址已占用

你的问题核心是并行测试时的容器资源竞争与初始化时序冲突，尤其是拆分新测试类后，新测试关联的DB容器可能未完全就绪、端口分配异常或资源未正确隔离，导致连接失败。以下是针对性的解决步骤：

1. 禁用手动端口锁定，确保Testcontainers动态端口机制生效 #

Testcontainers默认会自动分配未被占用的随机端口，手动锁定反而会加剧并行冲突。需重点检查：

• 新测试类中是否硬编码了数据库端口？必须使用容器提供的动态获取方法：

  // 正确写法：动态获取容器分配的连接信息
  String jdbcUrl = postgisContainer.getJdbcUrl();
  String username = postgisContainer.getUsername();
  String password = postgisContainer.getPassword();
  

• 确保每个测试类/方法使用独立的容器实例，不要用static修饰容器对象（static会导致多个测试共用同一容器，销毁或重启时引发资源冲突）。JUnit5推荐用@TestInstance(TestInstance.Lifecycle.PER_METHOD)保证实例级隔离。

2. 强制DB容器就绪后再启动业务测试 #

PostGIS/PostgreSQL容器启动需要一定时间，并行测试时容易出现业务服务先启动、DB未就绪的情况。添加精准的等待策略：

PostgisContainer<?> postgisContainer = new PostgisContainer<>("postgis/postgis:15-3.3")
    .waitingFor(Wait.forLogMessage(".*database system is ready to accept connections.*", 2)) // 等待DB就绪日志
    .waitingFor(Wait.forListeningPort()); // 额外确认端口监听状态

同时，在Jersey Test的configure()方法中延迟初始化数据源，确保DB容器完全启动后再配置连接。

3. 优化Gradle并行测试配置 #

调整Gradle测试任务的隔离性，减少跨测试的资源干扰：

test {
    useJUnitPlatform()
    maxParallelForks = (Runtime.getRuntime().availableProcessors() / 2).coerceAtLeast(1)
    forkEvery = 1 // 每个测试类启动独立JVM进程，避免类加载冲突
    timeout = 60000 // 延长测试超时时间，适配容器启动耗时
    testLogging {
        exceptionFormat = 'full' // 打印完整异常栈，方便定位问题
    }
}

4. 确保容器生命周期被正确管理 #

用Testcontainers的@Testcontainers注解自动管理容器的启动与销毁，替代手动的@AfterAll/@AfterEach，避免残留资源：

@Testcontainers
public class NewTestClass {
    @Container
    private final PostgisContainer<?> postgisContainer = new PostgisContainer<>("postgis/postgis:15-3.3")
        .withDatabaseName("testdb")
        .withUsername("testuser")
        .withPassword("testpass");

    // 测试方法...
}

该注解会确保每个测试类的容器在测试前启动，测试后自动销毁，彻底避免资源泄漏。

5. 排查新测试类的特殊逻辑 #

新测试类可能存在更复杂的DB初始化操作（如大量数据导入、多表创建），导致DB就绪时间变长：

• 临时添加调试等待（仅用于排查）：在测试方法开始前加入Thread.sleep(3000)，确认是否是时序问题。
• 检查连接池配置，如果使用HikariCP等连接池，调整maxWait、connectionTimeout参数，延长连接等待时间。

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