ASP.NET Core 8 Web API连接容器SQL Server失败，EF迁移报错求助

1. 修正连接字符串核心错误 #

你的DockerConnection连接字符串存在3处关键问题：

• Server地址错误：应使用db（对应docker-compose中定义的数据库服务名），而非db-
• 认证模式冲突：使用SA账号时，需将Trusted_Connection=True改为Trusted_Connection=False，否则会优先尝试容器不支持的Windows认证
• 证书信任缺失：SQL Server容器使用自签名证书，需添加TrustServerCertificate=True以绕过证书验证

修正后的连接字符串：

"DockerConnection": "Server=db;Database=TagManageDb;User Id=sa;Password=zaq1@WSX;Trusted_Connection=False;MultipleActiveResultSets=true;TrustServerCertificate=True"

2. 确保API加载正确的连接字符串 #

确认AppDbContext在Docker环境下使用DockerConnection而非本地连接，示例配置：

// 根据运行环境切换连接字符串
var connectionString = builder.Environment.IsDevelopment()
    ? builder.Configuration.GetConnectionString("LocalConnection")
    : builder.Configuration.GetConnectionString("DockerConnection");

builder.Services.AddDbContext<AppDbContext>(options =>
    options.UseSqlServer(connectionString));

也可通过Docker环境变量直接覆盖连接字符串，避免硬编码环境判断。

3. 处理数据库启动延迟问题 #

depends_on仅保证容器启动顺序，不保证SQL Server服务完全就绪。API启动时数据库可能仍在初始化，需添加重试逻辑：

var app = builder.Build();

using (var scope = app.Services.CreateScope())
{
    var services = scope.ServiceProvider;
    var context = services.GetRequiredService<AppDbContext>();
    
    const int maxRetries = 10;
    var retryCount = 0;
    while (retryCount < maxRetries)
    {
        try
        {
            if (context.Database.GetPendingMigrations().Any())
            {
                context.Database.Migrate();
            }
            break;
        }
        catch
        {
            retryCount++;
            Thread.Sleep(2000); // 间隔2秒重试
            if (retryCount == maxRetries) throw;
        }
    }
}

4. 验证容器状态与网络连通性 #

• 检查SQL Server容器是否就绪：

  docker-compose logs db
  

  日志中出现SQL Server is now ready for client connections即为就绪状态。

• 测试API容器与数据库容器的网络连通性：

  docker-compose exec api ping db
  docker-compose exec api telnet db 1433
  

  确认网络可达、1433端口开放。

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