VS2019/2022中System.Net.Http程序集加载失败问题求助

问题场景 #

项目基于.NET Framework 4.6.1，通过NuGet引入System.Net.Http 4.3.4版本，app.config中配置了如下绑定重定向：

<dependentAssembly>
  <assemblyIdentity name="System.Net.Http" publicKeyToken="b03f5f7f11d50a3a" culture="neutral" />
  <bindingRedirect oldVersion="0.0.0.0-4.2.0.0" newVersion="4.1.1.3" />
</dependentAssembly>

在VS2017中构建运行一切正常，bin目录下的dll版本为4.1.1.3；但切换到VS2019/2022构建后，bin目录下的dll版本自动变成4.2.0.0，运行时直接抛出System.IO.FileLoadException，提示程序集清单定义与引用不匹配。

原因解析 #

1. MSBuild工具链逻辑变更：VS2019及后续版本使用的MSBuild工具链，针对.NET Framework基础类库的引用规则做了调整。像System.Net.Http这类属于框架自带的程序集，工具链会优先从系统GAC或.NET Framework安装目录中拉取对应版本，而非严格遵循NuGet包指定的版本。
2. 自动绑定重定向覆盖：.NET Framework 4.6.1本身就包含System.Net.Http 4.2.0.0版本，VS2019+会自动生成或修改绑定重定向规则，直接覆盖你手动配置的内容，导致旧的重定向失效。
3. NuGet兼容包特性：System.Net.Http 4.3.4是一个兼容包，针对不同.NET Framework版本有适配逻辑，在VS2019+的工具链下，更倾向于使用框架自带版本而非NuGet包内的版本。

解决方案 #

• 调整绑定重定向规则：把newVersion改为实际输出的4.2.0.0，同时扩大oldVersion范围，确保所有旧版本请求都重定向到这个版本：

<dependentAssembly>
  <assemblyIdentity name="System.Net.Http" publicKeyToken="b03f5f7f11d50a3a" culture="neutral" />
  <bindingRedirect oldVersion="0.0.0.0-4.3.0.0" newVersion="4.2.0.0" />
</dependentAssembly>

• 禁用自动绑定重定向生成：在项目文件（.csproj）中添加以下配置，阻止VS自动修改重定向规则：

<PropertyGroup>
  <AutoGenerateBindingRedirects>false</AutoGenerateBindingRedirects>
  <GenerateBindingRedirectsOutputType>false</GenerateBindingRedirectsOutputType>
</PropertyGroup>

• 强制复制NuGet包中的dll：在项目文件里给System.Net.Http引用设置Private="True"，确保NuGet包中的4.1.1.3版本被复制到输出目录：

<Reference Include="System.Net.Http, Version=4.1.1.3, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a, processorArchitecture=MSIL">
  <HintPath>..\packages\System.Net.Http.4.3.4\lib\net46\System.Net.Http.dll</HintPath>
  <Private>True</Private>
</Reference>

• 升级目标框架：如果项目允许，升级到.NET Framework 4.7.2及以上版本，这些版本对System.Net.Http的版本冲突处理更稳定，能从根源减少这类问题。

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