Visual Studio 2015中WinSCPnet.dll版本不匹配问题排查求助

遇到这种明明换了旧版本却还是加载新版DLL的问题确实挺闹心，我帮你梳理几个容易忽略的排查要点：

• 检查绑定重定向配置
  打开项目的app.config（或web.config，如果是Web项目），查找<runtime>下的<assemblyBinding>节点，看看有没有针对WinSCPnet的绑定重定向规则。比如可能存在这样的配置：

  <dependentAssembly>
    <assemblyIdentity name="WinSCPnet" publicKeyToken="2271ec4a3c56d0bf" culture="neutral" />
    <bindingRedirect oldVersion="0.0.0.0-1.6.5.9925" newVersion="1.6.5.9925" />
  </dependentAssembly>
  

  把newVersion改成你当前使用的旧版本号，或者如果不需要重定向，直接删除这段配置。

• 核对引用属性设置
  右键项目中的WinSCPnet引用，打开属性面板：

  • 确认Specific Version设为True，避免程序自动尝试加载更高版本；
  • 检查Version是否和你安装的旧版本一致；
  • 确保Copy Local设为True，保证正确版本的DLL会被复制到输出目录。

• 检查解决方案内其他依赖项目
  如果你的类库被解决方案中的其他项目（比如控制台程序、Web应用）引用，务必检查这些项目：

  • 它们的WinSCPnet引用版本是否正确；
  • 它们的配置文件是否有错误的绑定重定向；
  • 清理这些项目的bin和obj目录，避免残留旧版DLL。

• 清理NuGet缓存与本地包目录
  NuGet的缓存可能残留了旧版包：

  • 在Visual Studio中，依次点击「工具」→「选项」→「NuGet包管理器」→「常规」，点击「清空所有NuGet缓存」；
  • 手动删除本地NuGet包目录（默认路径为C:\Users\<你的用户名>\.nuget\packages\winscpnet）下的新版文件夹；
  • 也可以用命令行清理：dotnet nuget locals all --clear（适用于.NET Core/.NET项目）。

• 检查发布或部署目录
  如果你的程序已经发布到某个目录，要确认该目录下是否还存在新版的WinSCPnet.dll。有时候清理重建只会处理项目的bin/obj，但发布目录的旧文件不会自动覆盖，导致运行时加载错误版本。

• 再次确认GAC中的残留
  虽然你已经用gacutil /u移除过，但可以精确检查并清理：
  以管理员身份打开命令提示符，运行：

  gacutil /l WinSCPnet
  

  如果列表中仍存在报错的1.6.5.9925版本，执行精确移除命令：

  gacutil /u WinSCPnet, Version=1.6.5.9925, Culture=neutral, PublicKeyToken=2271ec4a3c56d0bf
  

• 编辑项目文件修正引用路径
  右键项目→「卸载项目」，然后右键→「编辑.csproj」，查找所有<Reference>节点中关于WinSCPnet的配置，确认HintPath指向的是旧版本DLL的正确路径，同时删除任何残留的旧版本引用条目，保存后重新加载项目并重建。

• 用程序集绑定日志查看器追踪加载过程
  这个Windows自带工具能帮你定位问题根源：

  1. 以管理员身份运行Fuslogvw.exe（可以在开始菜单搜索找到）；
  2. 点击「设置」，选择「日志绑定失败」或「所有绑定」，指定日志目录；
  3. 运行你的程序，触发错误后回到工具，查看生成的日志，就能明确看到程序从哪里加载了错误版本的DLL，以及是谁发起的加载请求。

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