macOS下Docker中SQL Server无法连接ASP.NET Web API：SQL Server Browser连接失败

一、先确认Docker容器的SQL Server配置是否正确 #

• 若之前启动容器的参数不完整，重新启动容器（替换成你的SA密码）：

  docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=Str0ngP@ssword!" -p 1433:1433 --name sqlserver -d mcr.microsoft.com/mssql/server:latest
  

  注意：SA密码必须满足复杂度要求（至少8位，包含大小写字母、数字、特殊字符），否则容器会启动失败。
• 验证容器内SQL Server是否正常运行：

  docker exec -it sqlserver /opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P Str0ngP@ssword!
  

  能进入sqlcmd命令行则说明容器内服务正常；如果报错，查看容器日志排查问题：

  docker logs sqlserver
  

二、修复本地连接与连接字符串问题 #

1. 调整连接字符串 #

Linux版SQL Server对加密规则的要求和Windows不同，修改appsettings.json中的连接字符串，补充加密相关参数：

"ConnectionStrings": {
  "DefaultConnection": "Server=localhost,1433;Database=YourDB;User Id=sa;Password=Str0ngP@ssword!;TrustServerCertificate=True;Encrypt=Optional;"
}

同时确认YourDB已经在Azure Data Studio中创建，否则会提示数据库不存在。

2. 解决sqlcmd登录超时问题 #

macOS上的sqlcmd需要明确指定信任服务器证书，使用以下命令尝试连接：

/opt/homebrew/bin/sqlcmd -S localhost,1433 -U sa -P Str0ngP@ssword! -C

如果仍然超时，检查本地防火墙是否拦截了1433端口，或者重启Docker服务后再试。

三、关于SQL Server Browser错误的说明 #

Linux版SQL Server没有SQL Server Browser服务，该服务是Windows版用来动态发现数据库端口的工具。你遇到的这个错误，本质是连接参数或驱动的问题，并非真的需要启动Browser服务。只要连接时明确指定了1433端口，就无需依赖该服务。

四、ASP.NET Web API的额外配置 #

• 确保使用的是.NET 6及以上版本的SDK，跨平台数据库连接的兼容性更好。
• 在项目中安装Microsoft.Data.SqlClient包（推荐使用这个新版本的SQL客户端）：

  dotnet add package Microsoft.Data.SqlClient
  

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