Testcontainers如何忽略Dockerfile的EXPOSE指令 固定Couchbase测试端口映射

Testcontainers默认的端口映射逻辑：

• 启动容器前自动读取目标镜像Dockerfile中所有EXPOSE指令声明的端口，加入待映射列表
• 对待映射列表中的所有端口，若未通过withFixedExposedPort指定固定映射，自动分配宿主机临时随机端口完成映射
  你看到的多余随机端口，就是Testcontainers读取Couchbase官方镜像15个EXPOSE端口后，对未手动配置映射的端口自动做的绑定。要实现仅保留自定义固定端口映射的效果，只需要覆盖Testcontainers默认从镜像读取的EXPOSE端口列表即可，不需要修改镜像或调整Docker本身的配置。

1. 在原有容器定义代码中，完成环境变量、固定端口映射、日志消费者的配置后，手动重置容器的待暴露端口集合，完全覆盖从镜像自动读取的EXPOSE配置。
   对应新增的Scala代码：

   // 原有配置逻辑全部完成后，新增以下代码
   container.container.setExposedPorts(
     java.util.List.of(
       random8091Port,
       random8092Port,
       random8093Port,
       random8094Port,
       random11210Port
     )
   )
   

2. 规避常见配置误区：
   • 不要用withExposedPorts做覆盖：该方法是往默认待映射列表中追加端口，不会清除镜像自带的EXPOSE端口
   • 观察到的testcontainersofficial/ryuk容器是Testcontainers自带的资源回收组件，不属于Couchbase容器的端口映射，无需额外处理
   • 该配置不需要修改网络模式，只要重置了待映射端口列表，Testcontainers就不会为未声明的端口创建随机映射

修改完成后重启测试，通过docker ps查看Couchbase容器的端口映射，只会保留你自定义配置的5个端口规则，不会再出现Couchbase官方Dockerfile中其他未被你手动声明的多余随机端口。

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