我之前在Jenkins Kubernetes的DinD环境里跑Testcontainers集成测试时，也碰到过完全一样的问题——本地调试一切正常，一到CI流水线里就报「Requested port (X) is not mapped」的错误。结合你的配置和报错信息，我梳理了几个关键的排查点和解决方案：

1. 修正Testcontainers的Docker连接配置 #

你当前把TESTCONTAINERS_HOST_OVERRIDE设为tcp://localhost:2375，但看你的Jenkinsfile里挂载了宿主机的/var/run/docker.sock到DinD容器中，这意味着Testcontainers实际是在调用Kubernetes节点上的Docker守护进程，而非DinD容器内部的Docker服务。这时候应该把环境变量改成指向unix套接字：

envVars: [
    envVar(key: 'TESTCONTAINERS_HOST_OVERRIDE', value: 'unix:///var/run/docker.sock'),
    envVar(key: 'TESTCONTAINERS_DOCKER_SOCKET_OVERRIDE', value: '/var/run/docker.sock'),
    envVar(key: 'TESTCONTAINERS_RYUK_DISABLED', value: 'true'),
]

这样Testcontainers才能正确连接到节点上的Docker，获取容器的端口映射信息。

2. 确保容器启动后等待端口就绪 #

有时候容器虽然调用了start()方法，但内部服务还没完全启动，端口还没真正进入监听状态，这时候调用getFirstMappedPort()就会报错。建议在你的容器配置里加上等待端口就绪的逻辑：

// 以PostgreSQL容器为例，添加端口等待逻辑
public static final PostgreSQLContainer<?> POSTGRES = new PostgreSQLContainer<>("postgres:13")
    .withDatabaseName("testdb")
    .withUsername("testuser")
    .withPassword("testpass")
    .waitingFor(Wait.forListeningPort()); // 等待端口就绪

或者在启动后显式等待服务初始化完成：

Containers.POSTGRES.start();
// 等待PostgreSQL完全启动的日志标识
Containers.POSTGRES.waitingFor(Wait.forLogMessage("database system is ready to accept connections", 1));

3. 升级Testcontainers版本 #

你使用的1.15.3是2020年的旧版本，这个版本对Kubernetes+DinD环境的支持存在不少兼容性问题，比如端口映射的识别逻辑不够完善。建议升级到1.19.x或更高版本（比如最新的1.20.x系列），新版本修复了大量这类环境下的端口相关bug，能大幅减少这类奇怪的错误。

4. 验证Kubernetes节点的网络访问权限 #

当Testcontainers在节点上创建容器时，Jenkins Agent Pod需要能访问到这些容器的端口。如果你的集群使用了CNI网络插件，要确保Agent Pod所在的Namespace有足够的网络权限，能访问节点上的容器网络。如果尝试了前面的方法仍无效，可以临时给Agent Pod启用hostNetwork: true（在podTemplate中配置），让Pod直接使用节点的网络，这样就能直接访问节点上的容器端口，但这个选项要注意安全风险，生产环境需谨慎使用。

最后，建议在CI流水线中添加Docker环境验证步骤，确认Testcontainers连接的是正确的Docker守护进程：

container('docker-in-docker') {
    sh("docker info")
    sh("docker ps")
}

这样能帮你快速验证Testcontainers创建的容器是否在节点上正常运行，端口是否正确映射。

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