求助：.NET环境下TestContainers中Azure Functions容器无法连接SQL Server容器

问题场景 #

在.NET环境中使用TestContainers管理两个容器：

• SQL Server容器通过MsSqlBuilder创建：

var sqlContainer = new MsSqlBuilder()
            .WithImage("mcr.microsoft.com/mssql/server:2022-latest")
            .WithPassword("Passw0rd#123")
            .WithNetwork(network)
            .WithWaitStrategy(Wait.ForUnixContainer().UntilCommandIsCompleted("/opt/mssql-tools18/bin/sqlcmd -C -S localhost -U sa -P \"Passw0rd#123\" -Q \"SELECT 1\" -b -o /dev/null"))
            .Build();

• Azure Functions应用容器通过ContainerBuilder创建：

var functionContainer = new ContainerBuilder()
            .WithImage(image)
            .WithPortBinding(80, true)
            .WithWaitStrategy(Wait.ForUnixContainer().UntilHttpRequestIsSucceeded(r => r.ForPort(80), strategy => strategy.WithTimeout(30.Seconds())))
            .WithNetwork(network)
            .WithEnvironment(new Dictionary<string, string>
            {
                { "ConnectionStrings:Notification", notificationConnectionString }
            });

两个容器已加入同一自定义网络：

var network = new NetworkBuilder()
            .WithName(Guid.NewGuid().ToString("D"))
            .Build();

Azure Functions可正常启动，但调用其与SQL Server通信的端点时，出现错误：

A network-related or instance-specific error occurred while establishing a connection to SQL Server. The server was not found or was not accessible. Verify that the instance name is correct and that SQL Server is configured to allow remote connections.

主机可正常连接SQL Server容器，连接字符串配置无误，但容器间无法通信。

解决方法 #

1. 连接字符串使用SQL容器的网络别名而非localhost #

Docker自定义网络中，容器之间需通过容器名称/网络别名通信，而非localhost（localhost指向容器自身）。

修改SQL容器配置，添加网络别名：

var sqlContainer = new MsSqlBuilder()
    .WithImage("mcr.microsoft.com/mssql/server:2022-latest")
    .WithPassword("Passw0rd#123")
    .WithNetwork(network)
    .WithNetworkAliases("mssql-server") // 添加固定网络别名
    .WithEnvironment("ACCEPT_EULA", "Y") // 必须添加，否则SQL容器无法正常启动
    .WithWaitStrategy(Wait.ForUnixContainer().UntilCommandIsCompleted("/opt/mssql-tools18/bin/sqlcmd -C -S localhost -U sa -P \"Passw0rd#123\" -Q \"SELECT 1\" -b -o /dev/null"))
    .Build();

更新连接字符串：

将连接字符串中的服务器地址改为网络别名mssql-server，同时添加TrustServerCertificate=True（适配SQL Server 2022的加密连接要求）：

var notificationConnectionString = "Data Source=mssql-server;Initial Catalog=NotificationDB;User ID=sa;Password=Passw0rd#123;TrustServerCertificate=True";

2. 确保SQL容器完全就绪后再启动Functions容器 #

Functions容器启动时，SQL Server可能尚未完成初始化，导致连接失败。需等待SQL容器启动完成后，再启动Functions容器：

// 先启动SQL容器并等待就绪
await sqlContainer.StartAsync();

// 再构建并启动Functions容器
var functionContainer = new ContainerBuilder()
    .WithImage(image)
    .WithPortBinding(80, true)
    .WithWaitStrategy(Wait.ForUnixContainer().UntilHttpRequestIsSucceeded(r => r.ForPort(80), strategy => strategy.WithTimeout(30.Seconds())))
    .WithNetwork(network)
    .WithEnvironment(new Dictionary<string, string>
    {
        { "ConnectionStrings:Notification", notificationConnectionString }
    })
    .Build();

await functionContainer.StartAsync();

3. 验证SQL Server容器的远程连接配置 #

SQL Server容器默认允许远程连接，但可通过以下方式确认：

• 确保ACCEPT_EULA环境变量已设置为Y（否则容器无法正常初始化）
• 检查wait策略中的sqlcmd命令是否正常执行，确认SQL服务已就绪

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