Testcontainers-dotnet 中 MSSQL 容器在 Ubuntu 最新版上的运行问题解析

问题背景

Testcontainers-dotnet 是一个用于 .NET 生态系统的测试容器库，它允许开发者在测试环境中轻松启动和管理 Docker 容器。近期，在 Ubuntu 22.04 LTS 最新版本上运行时，MsSqlContainer 出现了启动失败的问题。

问题现象

当开发者在 Ubuntu 22.04 LTS（镜像版本 20240922.1.0）上运行 Testcontainers-dotnet 3.10.0 版本时，调用 MsSqlBuilder 的 StartAsync() 方法会抛出 DockerApiException 异常，错误信息显示容器未运行。

技术分析

这个问题的根本原因是 Ubuntu 22.04 LTS 最新版本与 MSSQL Server 容器镜像之间的兼容性问题。具体表现为：

1. 容器虽然成功创建，但无法正常启动运行
2. 等待策略检查失败，因为容器实际上并未处于运行状态
3. 错误信息显示 Docker API 返回了状态码 Conflict

解决方案

目前项目团队已经通过 PR 修复了这个问题。对于开发者而言，可以采取以下临时解决方案：

1. 显式指定 MSSQL Server 容器镜像版本：

   new MsSqlBuilder()
       .WithImage("mcr.microsoft.com/mssql/server:2022-CU14-ubuntu-22.04")
       // 其他配置
   

2. 在 GitHub Actions 中暂时使用较旧的 Ubuntu 版本作为运行环境

最佳实践建议

1. 在生产环境中，始终明确指定容器镜像版本，避免使用 latest 标签
2. 定期更新 Testcontainers-dotnet 库以获取最新的兼容性修复
3. 在 CI/CD 流水线中，考虑固定基础镜像版本以确保构建稳定性

总结

容器化测试环境虽然提供了便利，但也带来了环境兼容性的挑战。Testcontainers-dotnet 团队正在积极解决这些问题，开发者可以通过上述方案暂时规避当前问题。随着项目的持续更新，这些兼容性问题将得到更好的解决。