.NET 6 WinForm打包后启动报错：SqlClient不支持当前平台

可能的原因及对应解决步骤 #

1. 发布目标运行时与测试架构不匹配 #

• 问题：VS运行时会自动适配当前系统架构，但VDROJ打包若选择Any CPU，可能导致依赖特定架构的原生SNI库未正确嵌入
• 解决：
  1. 打开VDROJ项目，右键选择属性 → 发布 → 修改
  2. 在目标运行时下拉菜单中选择你测试时使用的架构（如win-x64或win-x86）
  3. 勾选将运行时包含在部署包中，重新发布

2. 原生SNI库未被正确复制到发布包 #

• 问题：即使安装了Microsoft.Data.SqlClient.SNI.runtime，打包过程可能未自动复制对应架构的原生文件
• 解决：编辑项目的.csproj文件，添加以下配置（替换版本号为你实际使用的版本）：

  <ItemGroup>
    <PackageReference Include="Microsoft.Data.SqlClient" Version="5.1.5" />
    <PackageReference Include="Microsoft.Data.SqlClient.SNI.runtime" Version="5.1.5" />
  </ItemGroup>
  <ItemGroup>
    <!-- 针对x64架构 -->
    <Content Include="$(MSBuildThisFileDirectory)runtimes\win-x64\native\Microsoft.Data.SqlClient.SNI.dll">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
      <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
    </Content>
    <!-- 针对x86架构 -->
    <Content Include="$(MSBuildThisFileDirectory)runtimes\win-x86\native\Microsoft.Data.SqlClient.SNI.dll">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
      <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
    </Content>
  </ItemGroup>
  

3. 发布裁剪优化误删依赖 #

• 问题：若发布时启用了裁剪未使用的代码，可能会误删Microsoft.Data.SqlClient的必要依赖
• 解决：
  • 临时方案：关闭发布配置中的裁剪未使用的代码选项，重新发布
  • 若必须保留裁剪：编辑.csproj添加以下配置，强制保留SqlClient相关组件：

    <PropertyGroup>
      <TrimMode>partial</TrimMode>
    </PropertyGroup>
    <ItemGroup>
      <TrimmerRootAssembly Include="Microsoft.Data.SqlClient" />
    </ItemGroup>
    

4. 绑定重定向缺失导致版本冲突 #

• 问题：VS运行时可能加载GAC中的旧版本SqlClient，而打包后的程序只能使用本地依赖，引发版本不兼容
• 解决：
  1. 在.csproj中启用自动绑定重定向：

     <PropertyGroup>
       <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
       <GenerateBindingRedirectsOutputType>true</GenerateBindingRedirectsOutputType>
     </PropertyGroup>
     

  2. 或者手动在app.config中添加版本重定向（替换版本号为实际使用版本）：

     <configuration>
       <runtime>
         <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
           <dependentAssembly>
             <assemblyIdentity name="Microsoft.Data.SqlClient" publicKeyToken="23ec7fc2d6eaa4a5" culture="neutral" />
             <bindingRedirect oldVersion="0.0.0.0-5.1.5.0" newVersion="5.1.5.0" />
           </dependentAssembly>
         </assemblyBinding>
       </runtime>
     </configuration>
     

5. 验证发布包文件结构 #

• 解压发布后的压缩包，检查是否存在runtimes/win-[x64/x86]/native目录，且目录下包含Microsoft.Data.SqlClient.SNI.dll
• 若文件缺失，回到步骤2重新配置项目文件

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