Testcontainers-dotnet 容器间通信问题解析与解决方案

在使用 Testcontainers-dotnet 进行端到端测试时，容器间通信是一个常见需求。本文将深入分析一个典型的 MSSQL 数据库与应用容器间的连接问题，并提供专业解决方案。

问题场景

开发者在 Windows 环境下使用 Testcontainers-dotnet 3.8.0 创建了两个容器：

1. MSSQL 数据库容器
2. 使用 EF Core 的 ASP.NET Core 应用容器

尽管已经正确配置了网络和依赖关系，应用容器仍无法连接到数据库容器，而主机和其他工具（如 Adminer）却能正常连接。

关键错误分析

从日志中可以看到连接尝试失败：

Opening connection to database '' on server 'brave_wescoff,60706'

这里暴露了两个关键问题：

1. 连接字符串中使用了容器名称和映射的主机端口（60706）
2. 在容器网络内部通信时错误地使用了主机端口映射

正确配置原则

在容器间通信时，必须遵循以下原则：

1. 网络隔离性：当容器加入同一个自定义网络时，它们通过该网络直接通信
2. 端口使用：应该使用容器内部的实际端口（如 MSSQL 的 1433），而非映射到主机的端口
3. 地址解析：应使用网络别名或容器名称作为主机地址

解决方案

正确的连接字符串配置应为：

Server=mssql,1433;user=sa;Password=Password1!;MultipleActiveResultSets=True;Encrypt=false

其中：

• mssql 是容器的网络别名（WithNetworkAliases 设置）
• 1433 是 MSSQL 容器的内部端口

实现要点

1. 网络配置：确保两个容器加入同一个网络

var network = new NetworkBuilder().Build();

2. 容器依赖：正确声明容器依赖关系

.DependsOn(mssql)
.WithNetwork(network)

3. 环境变量传递：确保应用容器获取正确的连接字符串

.WithEnvironment("ConnectionStrings__DefaultConnection", 
    "Server=mssql,1433;user=sa;Password=Password1!;...")

常见误区

1. 混淆主机端口与容器端口：在容器间通信时不应使用映射到主机的端口
2. 过度配置：不需要为内部通信设置端口映射（WithPortBinding）
3. DNS解析：在自定义网络中，容器名称和网络别名会自动解析

最佳实践

1. 为关键服务（如数据库）设置明确的网络别名
2. 在开发环境使用固定端口，避免动态端口带来的配置复杂度
3. 使用环境变量管理连接字符串，便于不同环境切换
4. 添加连接重试逻辑，处理容器启动时的短暂不可用情况

通过遵循这些原则和最佳实践，可以构建可靠的容器化测试环境，确保应用容器能够正确访问依赖的服务容器。