Testcontainers-dotnet项目在.NET 9环境下与Podman的兼容性问题分析

问题背景

Testcontainers-dotnet是一个用于在测试中管理Docker容器的.NET库。近期有用户报告在将项目从.NET 8升级到.NET 9后，出现了与Podman容器交互时的连接问题。这个问题表现为间歇性的"Connection reset by peer"错误，特别是在使用多个容器时更为明显。

问题现象

当用户尝试在.NET 9环境中运行Testcontainers-dotnet时，系统会随机抛出以下异常：

System.IO.IOException: Unable to read data from the transport connection: Connection reset by peer.

这个错误发生在容器启动阶段，特别是在执行Unix命令检查容器就绪状态时。值得注意的是，这个问题并非每次都会出现，而是在1-3次连续尝试中就能观察到。

技术分析

根本原因

经过分析，这个问题与底层Docker API客户端库(Docker.DotNet)在处理Podman连接时的行为有关。具体表现为：

1. 在MultiplexedStream读取输出时连接被意外重置
2. 主要发生在执行容器内命令检查就绪状态时
3. 问题在.NET 9环境下更为明显

环境因素

• 使用Podman 5.3.1(rootless模式)
• 通过Unix域套接字连接(/var/run/user/1000/podman/podman.sock)
• .NET 9.0.101环境
• Testcontainers-dotnet 4.1.0版本

解决方案与建议

虽然这个问题仍在跟踪解决中，但开发者可以尝试以下缓解措施：

1. 降级.NET版本：暂时回退到.NET 8环境可能避免此问题
2. 调整等待策略：尝试使用不同的容器就绪检查策略
3. 增加重试逻辑：在应用层添加适当的重试机制处理间歇性失败

技术细节

问题核心在于Docker.DotNet库的MultiplexedStream实现，在读取容器输出流时对连接中断的处理不够健壮。特别是在Podman环境下，这种问题更为常见。

对于使用SQL Server容器的场景，用户报告即使设置了以下配置也无法解决问题：

• 显式指定镜像版本
• 配置环境变量(ACCEPT_EULA, MSSQL_SA_PASSWORD等)
• 设置端口映射和等待策略
• 尝试启用/禁用容器重用

结论

Testcontainers-dotnet团队已经意识到这个问题，并在上游Docker.DotNet项目中跟踪解决进展。对于依赖Podman和.NET 9的用户，建议密切关注官方更新，同时可以考虑暂时使用替代方案或实施上述缓解措施。

这个问题也提醒我们，在升级.NET主要版本时，需要特别注意与容器化工具链的兼容性，特别是在非Docker环境下使用容器技术时。