Docker部署SQL Server后ASP.NET Core数据库迁移连接失败求助

核心原因 #

你的ASP.NET Core应用（postqueryapi）运行在Docker容器中，连接字符串里的Server=localhost指向的是应用容器自身，而非宿主机上的SQL Server容器。Docker Compose中，服务间需要通过服务名称进行网络通信。

具体修复步骤 #

1. 修改连接字符串 #

将ConnectionStrings中的Server=localhost替换为Docker Compose中SQL Server的服务名socialdb：

"ConnectionStrings": {
  "SqlServer": "Server=socialdb;Database=socialdb;User Id=sa;Password=Str0ngs@Passw0rd21;Encrypt=false;TrustServerCertificate=True"
}

2. 验证容器网络连通性 #

• 确认socialdb容器正常运行：执行docker ps查看容器状态，确保socialdb处于Up状态
• 若需要测试连通性，可进入postqueryapi容器内部执行ping命令：

  docker exec -it postqueryapi ping socialdb
  

  能ping通则说明网络正常。

其他排查点（若上述修复无效） #

• 确认SQL Server容器的环境变量MSSQL_SA_PASSWORD与连接字符串中的密码完全一致（注意大小写、特殊字符）
• 检查SQL Server容器是否允许远程连接：默认Docker镜像已开启远程连接，无需额外配置
• 优化异步调用方式：你的迁移代码用GetAwaiter().GetResult()可能引发死锁风险，建议改为标准异步调用：

  public static async Task InitializeDatabaseAsync(this WebApplication app)
  {
      using var scope = app.Services.CreateScope();
      var context = scope.ServiceProvider.GetRequiredService<DatabaseContext>();
      await context.Database.MigrateAsync();
  }
  

  随后在Program.cs中用await app.InitializeDatabaseAsync();调用。

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