使用SQL Server的ASP.NET微服务Docker Compose启动连接不稳定问题

核心问题分析 #

Docker Compose的depends_on仅保证容器启动顺序，不保证数据库服务完全就绪。SQL Server容器启动后需要额外时间完成初始化（比如配置SA密码、启动核心服务），而API服务启动时直接尝试连接，此时数据库还未准备好，导致首次连接失败。EnableRetryOnFailure是EF Core对数据库操作的重试规则，但如果启动阶段的初始化/迁移逻辑未触发重试，这个配置就无法发挥作用。

具体解决方案 #

1. 给SQL Server容器添加健康检查，确保服务就绪后再启动API

修改Docker Compose中的orderdb配置，添加健康检查规则，让API服务仅在数据库真正可用时才启动：

orderdb:
  container_name: orderdb
  environment:
    ACCEPT_EULA: Y
    MSSQL_SA_PASSWORD: somePassword...132
  restart: always
  ports:
    - "1402:1433"
  volumes:
    - orders_data:/var/opt/mssql/orders
  healthcheck:
    test: ["CMD-SHELL", "/opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P somePassword...132 -Q 'SELECT 1' || exit 1"]
    interval: 10s
    timeout: 5s
    retries: 10
    start_period: 15s

同步修改API服务的depends_on，依赖数据库的健康状态：

ordering.api:
  container_name: ordering.api
  environment:
    - ASPNETCORE_ENVIRONMENT=Development
    - "ConnectionStrings:OrderingConnectionString=Server=orderdb;Database=OrderDb;Integrated Security=false;TrustServerCertificate=True;User Id=sa;Password=<password>;"
    - "EventBusSettings:HostAddress=amqp://guest:guest@rabbitmq:5672"
  depends_on:
    orderdb:
      condition: service_healthy
    rabbitmq:
      condition: service_started
  ports:
    - "8004:80"

2. 强化EF Core重试策略，或在启动阶段手动等待数据库连接

如果健康检查仍有偶发问题，可以在API启动阶段主动等待数据库就绪，再执行迁移或初始化逻辑。在Program.cs中添加如下方法：

public static async Task WaitForDatabaseAsync(IServiceProvider serviceProvider)
{
    using var scope = serviceProvider.CreateScope();
    var dbContext = scope.ServiceProvider.GetRequiredService<OrderContext>();
    var retryCount = 0;
    const int maxRetries = 20;
    while (retryCount < maxRetries)
    {
        try
        {
            await dbContext.Database.OpenConnectionAsync();
            await dbContext.Database.MigrateAsync();
            break;
        }
        catch (SqlException)
        {
            retryCount++;
            await Task.Delay(1000);
        }
    }
}

然后在builder.Build()之后调用：

var app = builder.Build();

// 等待数据库就绪并执行迁移
await WaitForDatabaseAsync(app.Services);

// 后续中间件配置...
app.Run();

同时可以调整EF Core的重试参数，增加重试次数和间隔：

services.AddDbContext<OrderContext>(options =>
    options.UseSqlServer(configuration.GetConnectionString("OrderingConnectionString"),
        opt => opt.EnableRetryOnFailure(
            maxRetryCount: 10,
            maxRetryDelay: TimeSpan.FromSeconds(5),
            errorNumbersToAdd: null)));

3. 排查连接字符串与容器初始化问题

• 确认连接字符串中的密码与orderdb容器的MSSQL_SA_PASSWORD完全一致，注意特殊字符的转义（Docker Compose中密码含特殊字符需用引号包裹）。
• 查看SQL Server容器启动日志：执行docker logs orderdb，检查是否有初始化错误，比如密码复杂度不符合要求（SQL Server要求SA密码至少8位，包含大小写、数字和特殊字符）。

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