升级EF Core 1.1至2.1时遇System.ValueTuple加载失败问题求助

你遇到的这个System.ValueTuple版本冲突问题，在.NET Framework 4.7环境下升级EF Core 2.x时确实挺常见的，我给你几个针对性的排查和解决步骤，建议按顺序尝试：

1. 排查全局程序集缓存（GAC）的干扰 #

有时候GAC里残留的旧版本组件会覆盖项目的本地引用，先做个检查：

• 以管理员身份打开命令提示符，运行：

  gacutil /l System.ValueTuple
  

• 如果查到版本低于4.4.0的条目，用以下命令卸载旧版本（把xxx.xxx.xxx替换成实际查到的版本号）：

  gacutil /u System.ValueTuple,Version=xxx.xxx.xxx,PublicKeyToken=cc7b13ffcd2ddd51
  

2. 修正绑定重定向的版本范围 #

官方给出的重定向范围可能没覆盖到你当前安装的4.4.0版本，试试把范围扩大：
在app.config或web.config的<runtime>标签内添加（或替换原有配置）：

<dependentAssembly>
  <assemblyIdentity name="System.ValueTuple" publicKeyToken="cc7b13ffcd2ddd51" culture="neutral" />
  <bindingRedirect oldVersion="0.0.0.0-4.4.0.0" newVersion="4.4.0.0" />
</dependentAssembly>

注意：如果你的解决方案里有多个项目（比如测试项目），要确保所有项目的config文件都加上这个配置。

3. 清理NuGet缓存与本地编译文件 #

旧缓存的包文件很容易导致版本混乱：

• 关闭Visual Studio，删除项目目录下的obj和bin文件夹；
• 打开NuGet包管理器控制台，运行强制重装命令：

  Update-Package -reinstall System.ValueTuple
  

• 还可以清理全局NuGet缓存，避免残留旧包：

  nuget locals all -clear
  

4. 检查第三方依赖的隐式引用 #

有些第三方NuGet包可能偷偷依赖了旧版本的System.ValueTuple，你可以这样排查：

• 在Visual Studio中右键项目 → 「管理NuGet程序包」→ 切换到「已安装」标签，逐一查看每个包的依赖关系；
• 或者用NuGet Package Explorer打开可疑的包，直接查看它的依赖项列表；
• 如果找到这类包，优先升级到最新版本，大概率能解决依赖冲突。

5. 强制添加本地引用兜底 #

如果以上方法都无效，试试直接引用本地的dll：
右键项目 → 「添加」→ 「引用」→ 「浏览」，找到NuGet包安装目录下的System.ValueTuple.dll（一般路径是packages\System.ValueTuple.4.4.0\lib\net47），添加引用后，设置该引用的「复制本地」属性为True，确保编译时会把正确版本的dll复制到输出目录。

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