Docker Compose中EF Core .NET API无法连接SQL Server容器求助

1. 确认Docker Compose网络与连接字符串匹配 #

• 确保API和SQL Server容器处于同一Docker网络（Docker Compose默认会自动创建专属网络，无需额外配置，但要避免手动指定不同网络）
• 连接字符串中必须使用SQL Server容器的服务名称（而非localhost/127.0.0.1）作为服务器地址，比如容器服务名为sqlserver，则连接字符串中的服务器名写sqlserver

2. 给SQL Server容器添加健康检查，避免API提前初始化 #

SQL Server容器启动后需要1-2分钟完成初始化，API不能在SQL就绪前发起连接。在docker-compose.yml中给SQL服务添加健康检查，并让API依赖其健康状态：

services:
  api:
    build: ./api
    depends_on:
      sqlserver:
        condition: service_healthy
    # 其他API配置...

  sqlserver:
    image: mcr.microsoft.com/mssql/server:2022-latest
    environment:
      SA_PASSWORD: "YourStrong!Passw0rd"
      ACCEPT_EULA: "Y"
    healthcheck:
      test: ["CMD-SHELL", "/opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P 'YourStrong!Passw0rd' -Q 'SELECT 1' || exit 1"]
      interval: 10s
      timeout: 5s
      retries: 5
    # 其他SQL配置...

3. 修正连接字符串的关键参数 #

确保连接字符串包含以下必要配置，避免SSL或认证错误：

// Program.cs中的连接字符串示例
builder.Configuration["ConnectionStrings:DefaultConnection"] = 
  "Server=sqlserver,1433;Database=YourDbName;User Id=sa;Password=YourStrong!Passw0rd;TrustServerCertificate=True;";

核心注意点：

• 必须添加TrustServerCertificate=True，绕过Docker环境下的SQL SSL证书验证
• 密码、数据库名要与SQL容器的环境变量完全一致

4. 给EF Core初始化添加重试逻辑 #

在Program.cs中用重试策略包裹数据库初始化代码，应对SQL初始化延迟：

var app = builder.Build();

// 初始化数据库（带重试）
using (var scope = app.Services.CreateScope())
{
    var dbContext = scope.ServiceProvider.GetRequiredService<YourDbContext>();
    // 用Polly实现指数退避重试
    var retryPolicy = Policy.Handle<SqlException>()
                            .WaitAndRetry(5, retryAttempt => TimeSpan.FromSeconds(Math.Pow(2, retryAttempt)));
    retryPolicy.Execute(() =>
    {
        dbContext.Database.EnsureCreated();
        // 执行测试数据初始化
        DbInitializer.Seed(dbContext);
    });
}

// 其他中间件配置...
app.Run();

需要先安装Polly NuGet包：Install-Package Polly

5. 通过日志定位具体错误 #

• 查看SQL Server容器日志，确认初始化是否完成、认证是否正常：

  docker logs <sqlserver-container-name>
  

• 查看API容器日志，明确连接错误类型（超时/认证失败/服务器不可达）：

  docker logs <api-container-name>
  

6. 测试容器间网络连通性 #

• 进入API容器，ping SQL容器名称验证网络可达：

  docker exec -it <api-container-name> ping sqlserver
  

• 测试1433端口是否开放：

  docker exec -it <api-container-name> telnet sqlserver 1433
  

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