.Net Core 2.2独立发布Win x64时System.Data.SqlClient平台不支持问题排查

这个问题在.NET Core 2.2独立发布Win x64场景下挺常见的，核心原因主要和System.Data.SqlClient的依赖包在独立部署时未被正确包含有关，具体来说有这几个可能：

1. 旧版System.Data.SqlClient的平台支持限制 #

虽然你提到用了最新的Sql Server类库，但如果项目里还是引用的System.Data.SqlClient而非微软推荐的Microsoft.Data.SqlClient，就容易出问题。因为微软已经将SqlClient的后续开发转移到Microsoft.Data.SqlClient，旧的System.Data.SqlClient在.NET Core 2.x的独立部署场景中，对特定平台的原生依赖（比如Windows下的sni.dll等）处理不够完善——VS运行时因为依赖框架环境，这些组件会自动加载，但独立发布时就会缺失。

2. 独立发布时未包含必要的原生运行时包 #

即使你用了正确的SqlClient包，.NET Core 2.2在独立发布时，默认可能不会自动包含SqlClient所需的原生平台组件。这些组件是连接SQL Server必须的，缺失就会触发平台不支持的错误。

对应的解决方案 #

方案一：迁移到Microsoft.Data.SqlClient（最推荐） #

这是微软官方推荐的做法，它是最新的SqlClient实现，对.NET Core的支持更完善，尤其是独立部署场景：

• 移除项目中对System.Data.SqlClient的引用
• 添加Microsoft.Data.SqlClient的NuGet包引用：

  dotnet add package Microsoft.Data.SqlClient
  

• 把代码中所有System.Data.SqlClient相关的命名空间替换为Microsoft.Data.SqlClient（比如SqlConnection、SqlCommand等）

方案二：为System.Data.SqlClient添加原生运行时包（若必须保留旧包） #

如果因为业务限制不能迁移，需要显式添加对应平台的原生依赖包：

• 在项目的.csproj文件中添加以下引用：

  <PackageReference Include="System.Data.SqlClient.SNI.runtime" Version="4.8.5" />
  

  版本号可以根据你使用的System.Data.SqlClient版本调整，尽量匹配最新兼容版本。

方案三：检查发布命令和项目配置 #

确保你发布时指定了正确的运行时标识符，并且是独立部署模式：

• 使用正确的发布命令：

  dotnet publish -c Release -r win-x64 --self-contained true
  

• 检查项目文件中是否设置了正确的RuntimeIdentifier：

  <PropertyGroup>
    <RuntimeIdentifier>win-x64</RuntimeIdentifier>
  </PropertyGroup>
  

方案四：排查依赖冲突 #

有时候项目中的其他NuGet包可能间接引用了旧版本的System.Data.SqlClient，导致版本冲突。可以用以下命令查看项目的依赖树：

dotnet list package --include-transitive

如果发现有旧版本的依赖，通过在.csproj中添加PackageReference并指定版本来强制统一：

<PackageReference Include="System.Data.SqlClient" Version="4.8.5" />

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