ASP.NET Core应用无法连接Docker容器中SQL Server的问题咨询

1 先验证Docker SQL Server运行基础配置 #

• 检查容器启动命令是否正确配置了端口映射：启动SQL Server容器时必须添加-p 1433:1433参数，将宿主机1433端口映射到容器内SQL Server默认端口，否则无法通过localhost访问。
• 检查sa密码是否匹配且符合规则：Docker版SQL Server要求sa密码至少8位，包含大小写字母、数字、特殊符号，启动容器时设置的SA_PASSWORD环境变量必须和连接字符串中的Password参数完全一致，无大小写、字符输入错误。
• 用docker ps命令确认容器处于运行状态，如果容器自动退出，执行docker logs <容器ID>查看报错，90%以上是sa密码不符合强规范导致启动失败。

2 验证SQL Server实例可访问性 #

先不运行ASP.NET Core项目，直接用Azure Data Studio连接Docker实例：

• 服务器地址填localhost,1433
• 身份验证选择「SQL 登录」，用户名填sa，密码填你设置的sa密码
  如果无法连接，说明问题出在容器配置层面，和连接字符串无关；如果可以连接，检查实例中是否存在BalDict数据库：你Windows环境下的数据库是存储在本地SQL Server实例中的，Docker实例为全新空实例，默认没有该数据库，这是你报错的最常见原因。

3 缺失数据库的解决方案 #

有两种方法可以创建对应的数据库：

• 如果你使用Entity Framework Core做数据访问，直接在项目目录下执行CLI命令dotnet ef database update，即可自动根据迁移文件创建库和表结构。
• 如果你需要迁移原有数据，可以将Windows环境下的BalDict库备份为.bak文件，在Azure Data Studio中连接Docker实例后执行还原操作。

4 连接字符串优化 #

确认以上配置都正确后，可将连接字符串修改为如下形式，覆盖常见验证问题：

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=localhost,1433;Database=BalDict;User Id=sa;Password=MySecurePass;MultipleActiveResultSets=true;TrustServerCertificate=True;"
  }
}

新增的两个参数作用：

• 显式指定1433端口，避免本地其他服务占用端口导致的连接异常
• 新增TrustServerCertificate=True参数，跳过Docker SQL Server默认自签证书的校验，避免证书报错

特殊情况处理 #

如果你的Mac本地1433端口被其他服务占用，可以修改端口映射为-p 14330:1433，对应连接字符串中的服务器地址修改为localhost,14330即可。

内容的提问来源于stack exchange，提问作者Amir Dora.