如何在Maven各阶段间传递Testcontainers的端口与容器名参数

项目使用Failsafe执行集成测试，包含10个同域独立应用，每个应用都有专属集成测试用例。所有测试依赖3个Testcontainers容器；每个应用依赖SparkSession（同一JVM内仅能存在一个实例），且各自的StreamingContext配置存在差异。单应用测试耗时约5分钟，全量串行测试总耗时达50分钟，因此尝试并行化优化：

• 同一JVM多线程执行：因StreamingContext实例冲突导致应用崩溃；
• 配置Failsafe的forkCount：每个测试启动独立JVM，最终生成40个Docker容器，超出机器内存承载上限。

当前计划采用prehook启动容器（禁用Ryuk管理器）、posthook销毁容器的方案，集成测试通过Docker HTTP API连接容器。但遇到核心问题：如何将prehook中获取的容器端口、名称传递到integration-test阶段及posthook？ 且不能使用固定端口/容器名，否则多流水线并行时会触发Docker资源冲突。

此前尝试过用codehaus.mojo的exec:java在Maven主JVM中启动Testcontainers，供Failsafe分叉出的JVM使用，但无法实现内存状态克隆，导致测试无法正常连接容器。

可行解决思路 #

1. 临时配置文件+Maven属性传递 #

在prehook启动容器后，将容器的端口、名称等信息写入target目录下的临时配置文件（如target/testcontainers.properties），同时通过Maven属性暴露文件路径，让后续阶段可以读取：

• prehook阶段：自定义启动容器的Java代码，将容器信息写入配置文件，格式示例：

  container.db.name=test-db-7f9a2c
  container.db.port=32891
  container.cache.name=test-cache-4d6b1e
  container.cache.port=31745
  

• Failsafe配置：通过systemPropertyVariables将配置文件路径传递给测试JVM：

  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-failsafe-plugin</artifactId>
    <configuration>
      <systemPropertyVariables>
        <testcontainers.config.path>${project.build.directory}/testcontainers.properties</testcontainers.config.path>
      </systemPropertyVariables>
    </configuration>
  </plugin>
  

• 测试代码与posthook：测试代码读取配置文件获取连接信息；posthook阶段同样读取该文件，根据容器名执行销毁命令。

2. Maven会话属性直接传递 #

通过自定义Java类在prehook中启动容器，并利用Maven API将容器端口、名称设置为Maven会话属性，后续阶段直接引用：

• prehook执行逻辑：在exec:java调用的类中，启动容器后通过MavenSession设置属性，如container.db.port、container.db.name；
• Failsafe配置：直接引用这些会话属性作为测试JVM的系统变量：

  <configuration>
    <systemPropertyVariables>
      <db.port>${container.db.port}</db.port>
      <db.container.name>${container.db.name}</db.container.name>
    </systemPropertyVariables>
  </configuration>
  

• posthook阶段：直接引用Maven会话属性，执行容器销毁命令。

3. Docker标签标记+批量清理 #

无需传递容器名，在prehook启动容器时添加唯一标签（结合CI流水线ID、项目ID或时间戳），posthook阶段通过标签匹配容器并批量销毁：

• 启动容器时打标签：

  GenericContainer dbContainer = new GenericContainer("postgres:14")
    .withLabel("test.env", "${CI_PIPELINE_ID}-${project.groupId}")
    .start();
  

• posthook清理命令：

  docker rm -f $(docker ps -q -f label=test.env=${CI_PIPELINE_ID}-${project.groupId})
  

通过标签唯一性（比如用GitLab的CI_PIPELINE_ID或Jenkins的BUILD_ID），确保多流水线并行时不会误删其他容器。

注意事项 #

• 临时文件需放在target目录，利用Maven构建生命周期自动清理，避免残留；
• 标签/属性的唯一性要结合CI环境变量保证，彻底避免多流水线资源冲突；
• 禁止依赖内存状态传递信息，Failsafe分叉的JVM是独立进程，只能通过文件、环境变量或Maven属性这类外部方式共享数据。

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