两个.NET 6 EF API连接Docker中SQL Server容器：一个可连一个失败

1. 核对连接字符串的核心细节 #

• 检查User Id是否为sa：你通过Docker搭建SQL Server时，默认仅创建sa管理员账户，若连接字符串中写了自定义username，必然无法认证。将User Id改为sa再尝试。
• 显式指定端口：修改连接字符串为Server=host.docker.internal,1433;database=Nameofdb;User Id=sa;Password=<你的密码>;，避免系统自动选择错误端口。

2. 确认API的运行环境限制 #

• 若第二个API在Docker容器内运行：host.docker.internal仅适用于宿主机访问容器，容器内访问宿主机时，Linux环境需替换为宿主机IP，或在API的Docker启动命令中添加--add-host=host.docker.internal:host-gateway；Windows环境可直接使用该域名，但需确认Docker网络配置正常。
• 若在宿主机直接运行API：检查防火墙是否阻止了该API进程访问1433端口，可临时关闭防火墙测试，或为API进程添加出站允许规则。

3. 验证EF Core的配置正确性 #

• 检查DbContext的注册代码：确保Program.cs中正确读取了连接字符串，示例代码如下：

  builder.Services.AddDbContext<YourDbContext>(options =>
      options.UseSqlServer(builder.Configuration.GetConnectionString("YourConnName")));
  

  确认appsettings.json中的连接字符串名称与代码中的名称完全一致，无拼写错误。
• 绕过EF直接测试连接：在Program.cs中添加一段原生SQL连接代码，排除EF的干扰：

  using var conn = new SqlConnection("你的完整连接字符串");
  try
  {
      await conn.OpenAsync();
      Console.WriteLine("连接成功");
  }
  catch (Exception ex)
  {
      Console.WriteLine($"连接失败：{ex.Message}");
  }
  

4. 检查SQL Server容器状态 #

• 查看容器启动日志：执行docker logs <你的容器名>，确认SQL Server是否正常启动，重点检查是否有密码复杂度不符合要求的报错（SQL Server要求SA密码至少8位，包含大小写、数字、特殊字符）。
• 确认端口映射：执行docker ps，查看PORTS列是否显示0.0.0.0:1433->1433/tcp，若映射异常，需重启容器并重新指定端口参数。

5. 其他排查点 #

• 确认API的.NET版本：检查第二个API的项目文件，确保确实是.NET 6版本，避免因版本差异导致SQL Client兼容性问题。
• 清理项目缓存：删除API项目的bin和obj文件夹，重新生成项目后再执行dotnet ef database update。

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