.NET 8 Docker容器无法连接本地SQL Server问题

针对你遇到的.NET 8控制台应用Docker部署后无法连接本地SQL Server、报错SQL Server Browser相关的问题，结合.NET 6/7可正常运行的情况，给你几个可行的解决方向：

1. 绕过SQL Server Browser，直接指定实例端口 #

SQL Server Browser服务（UDP 1434端口）用于通过实例名解析对应TCP端口，但容器环境下可能因网络隔离或.NET 8网络策略无法访问该服务。你可以直接指定实例的TCP端口连接：

• 打开SQL Server配置管理器，找到INST1实例，查看其TCP/IP协议的监听端口（命名实例一般是动态端口，可改为固定端口）
• 修改连接字符串为：

  Server=你的IP地址,实例端口号;Database=目标库名;User Id=账号;Password=密码;TrustServerCertificate=True;
  

  无需依赖SQL Server Browser服务，直接通过端口建立连接。

2. 使用Docker主机网络模式运行容器 #

Docker默认桥接网络会隔离容器与主机的网络栈，导致容器无法访问主机上的SQL Server Browser服务。运行容器时可指定主机网络模式：

docker run --network host 你的镜像名

该模式下容器直接使用主机网络栈，可直接访问主机上的所有服务（包括SQL Server Browser）。注意：

• Windows Docker环境下主机网络模式支持有限，需调整Windows防火墙规则，允许容器访问主机1434端口
• Linux Docker环境下该模式生效正常，但要留意端口冲突问题

3. 调整.NET 8的DNS解析策略 #

.NET 8对DNS解析做了行为变更，可能影响实例名解析。你可在应用启动时添加以下代码，启用旧版DNS递归策略：

AppContext.SetSwitch("System.Net.Dns.EnableLegacyRecursion", true);

或在项目.csproj文件中添加配置：

<ItemGroup>
  <RuntimeHostConfigurationOption Include="System.Net.Dns.EnableLegacyRecursion" Value="true" />
</ItemGroup>

让.NET 8的DNS解析行为与.NET 6/7保持一致，解决实例名解析失败问题。

4. 验证容器内的网络连通性 #

先确认容器能正常访问主机网络：

• 进入容器内部：docker exec -it 容器ID /bin/bash（Linux容器）或docker exec -it 容器ID cmd（Windows容器）
• 测试主机IP连通性：ping 你的主机IP
• 测试SQL Server Browser端口：nc -zv 你的主机IP 1434（Linux容器），若能通则网络无问题，问题出在.NET 8解析逻辑；若不通，检查主机防火墙是否允许1434端口的UDP流量，或调整Docker网络配置。

内容的提问来源于stack exchange，提问作者Emiliyan Ivanov Angelov