.NET编译时解析版本不符的System.Net.Http的机制及潜在风险

项目配置详情 #

.csproj配置 #

• 目标框架：.NET Framework 4.8
• 引用程序集版本：4.1.1.3
• 引用本地NuGet包路径：..\packages\System.Net.Http.4.3.4\lib\net46\System.Net.Http.dll（该DLL程序集版本为4.1.1.3）

app.config配置 #

• 运行时绑定重定向配置：

  <bindingRedirect oldVersion="0.0.0.0-4.2.0.0" newVersion="4.0.0.0"/>
  

当前现象 #

项目编译成功后，System.Net.Http.dll未出现在bin目录；全局程序集缓存（GAC）仅存在v4.0_4.0.0.0版本，运行无明显错误。

现有编译与运行阶段认知 #

编译阶段 #

1. 编译器检查项目文件中的引用程序集版本
2. 检查GAC是否存在该引用版本
3. 若GAC不存在则在项目引用路径查找
4. 未找到则编译报错

运行阶段 #

1. CLR尝试加载项目引用的程序集版本
2. 找不到则查找绑定重定向配置
3. 找到则加载重定向指定版本，否则运行报错

具体疑问 #

1. 编译器检查了项目引用版本，为何未将System.Net.Http复制到bin目录？
2. 该配置是否会导致仅适配System.Net.Http 4.1.1.3的代码编译成功，但因运行时仅加载4.0.0.0版本而报错？

问题解答 #

1. 为何System.Net.Http未被复制到bin目录？ #

这是因为System.Net.Http在.NET Framework 4.6及以上版本中属于框架的“内置程序集”，即使通过NuGet引用了独立包，编译器和MSBuild会自动识别这类特殊程序集的处理规则：

• 当项目目标框架为.NET Framework 4.6+时，MSBuild会判断该程序集是否属于框架提供的核心组件，若匹配则不会将本地NuGet中的DLL复制到bin目录，优先依赖GAC或框架自带版本。
• 你的绑定重定向已指定运行时使用4.0.0.0版本，而该版本存在于GAC中，MSBuild会判定无需复制本地DLL到输出目录——因为运行时会直接从GAC加载重定向后的版本。

另外，可检查项目引用的Copy Local属性，若该属性设为False也会导致DLL不复制到bin目录；对于框架内置程序集，这个属性通常会被自动设为False。

2. 是否会出现编译适配4.1.1.3但运行加载4.0.0.0的报错？ #

大概率不会出现报错，原因如下：

• API兼容性：System.Net.Http 4.1.1.3是NuGet提供的.NET Framework兼容版本，核心API与框架内置的4.0.0.0版本高度一致，编译时用到的常规API在运行时版本中都存在。
• 绑定重定向的作用：CLR运行时会严格按照配置，将所有对0.0.0.0-4.2.0.0版本的请求重定向到4.0.0.0版本，只要代码未使用4.1.1.3特有的API（如少量新增扩展方法），就不会触发错误。
• 当前运行无错误的情况也说明，你的代码并未用到两个版本间不兼容的API。

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