使用TestContainers运行.NET Core 6容器报DockerApiException冲突错误求助

问题根源 #

你的Dockerfile采用多阶段构建，TestContainers默认不会自动选择最后一个final运行阶段，而是仅构建到publish阶段。publish阶段基于sdk镜像，缺少正确的运行时入口配置，导致容器无法正常启动，进而抛出"容器未运行"的冲突异常。

修复步骤 #

1. 显式指定TestContainers构建目标阶段 #

在TestContainers的配置代码中，明确指定构建的目标阶段为final，确保使用运行时镜像启动容器。以.NET TestContainers为例，修改代码如下：

var appContainer = new TestcontainersBuilder<TestcontainersContainer>()
    .WithDockerfile("Dockerfile")
    .WithBuildTarget("final") // 指定构建final阶段
    .WithPortBinding(80, true)
    .Build();

await appContainer.StartAsync();

2. 排查容器启动日志 #

添加日志输出，定位容器启动失败的具体细节（比如依赖缺失、DLL路径错误等）：

await appContainer.StartAsync();
var logs = await appContainer.GetLogsAsync();
Console.WriteLine("标准输出：");
Console.WriteLine(logs.Stdout);
Console.WriteLine("错误输出：");
Console.WriteLine(logs.Stderr);

3. 本地验证final阶段镜像 #

先手动构建并运行final阶段镜像，确认镜像本身无问题：

# 构建final阶段镜像
docker build -t myapp-runtime --target final .

# 启动容器测试
docker run -p 8080:80 myapp-runtime

如果本地运行正常，说明问题确实出在TestContainers未指定构建阶段。

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