使用Spock+Testcontainers启动OpenLiberty容器时遇ContainerLaunchException

下面是几个大概率导致你遇到的ContainerLaunchException连接问题的原因及解决办法：

1. 端口映射未正确使用Testcontainers动态端口 #

Testcontainers会自动将容器内部端口映射到主机的随机端口，如果你在测试代码里硬写容器内部端口（比如9080），而非调用容器的getMappedPort()方法获取实际映射的主机端口，必然会连接失败。

正确用法示例：

def container = new OpenLibertyContainer("openliberty/open-liberty:full-java17-openj9")
container.start()
// 获取Testcontainers映射后的主机端口
def mappedPort = container.getMappedPort(9080)
def appUrl = "http://localhost:${mappedPort}/your-app-path"

2. 就绪等待策略不匹配服务实际状态 #

虽然容器日志显示服务就绪，但Testcontainers默认的等待策略可能没正确识别OpenLiberty的应用部署完成信号——比如只等容器启动，没等MicroProfile应用真正就绪，导致测试提前发起连接。

自定义等待策略示例：

// 等待MicroProfile健康检查就绪端点返回200
container.waitingFor(Wait.forHttp("/health/ready")
        .forStatusCode(200)
        .withStartupTimeout(Duration.ofMinutes(2)))

// 或者匹配OpenLiberty应用启动完成的日志关键字
container.waitingFor(Wait.forLogMessage(".*CWWKZ0001I: Application.* started in.*", 1))

3. WAR包或配置文件挂载路径错误 #

直接用Docker run时的挂载路径，和Testcontainers中的挂载逻辑可能不一致。比如OpenLiberty默认应用部署目录是/config/apps，如果测试代码中挂载WAR包的路径错误，容器虽启动但未加载你的应用，会导致访问失败。

正确挂载示例：

// 将本地构建好的WAR包挂载到OpenLiberty的应用部署目录
container.withCopyFileToContainer(
    MountableFile.forHostPath("build/libs/your-app.war"), 
    "/config/apps/your-app.war"
)

也可以在测试失败后暂停容器，进入容器查看/config/apps目录确认文件是否存在。

4. Gradle任务依赖未正确关联 #

即便你配置了生成WAR包的任务，如果测试任务（如test）和WAR生成任务（war）的依赖没正确设置，可能出现测试先执行、WAR包还未生成/还是旧版本的情况，导致容器加载无效应用，服务看似就绪但无可用接口。

添加任务依赖：
在build.gradle中明确关联：

test.dependsOn war

确保测试执行前先完成WAR包构建。

5. 本地网络/防火墙限制 #

极少数情况下，本地防火墙可能阻断了Testcontainers映射的端口，或者Testcontainers默认网络配置异常。可以临时关闭防火墙测试，或检查Testcontainers是否使用了正确的桥接网络模式。

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