WPF报无法加载Syncfusion.SfGrid.WPF程序集或依赖项 搜索路径错误

问题现象 #

代码此前运行正常、无相关改动的前提下突然抛出如下异常：

System.Windows.Markup.XamlParseException: 'Could not load file or assembly 'Syncfusion.SfGrid.WPF, PublicKeyToken=3d67ed1f87d44c89' or one of its dependencies. The system cannot find the file specified.'
内部异常：FileNotFoundException: Could not load file or assembly 'Syncfusion.SfGrid.WPF, PublicKeyToken=3d67ed1f87d44c89' or one of its dependencies. The system cannot find the file specified.'

已尝试清理解决方案、重新生成，确认Syncfusion.SfGrid.WPF.dll物理存在于项目/bin/Debug目录，解决方案内所有项目引用的该dll版本一致，通过fuslogvw排查发现加载逻辑未检索该dll所在的bin目录。

排查解决步骤 #

按优先级从高到低依次验证：

• 确认实际运行的输出目录是否正确
  不要直接默认当前打开的bin/Debug就是运行时探测目录：启动调试后通过VS菜单「调试→窗口→模块」查看当前进程加载的所有程序集路径，确认进程的基目录。常见误区包括：多启动项目配置错误导致启动了其他项目的输出目录、平台目标（x86/x64/Any CPU）和活动解决方案平台不匹配导致输出到了bin/x64/Debug等其他路径、项目设置了自定义输出路径未同步更新、开启了VS调试加速/热重载的影子拷贝机制导致程序运行在临时目录。如果是影子拷贝问题，直接关闭调试相关的热重载、加速选项即可。
• 确认启动项目存在直接包引用
  若Syncfusion包仅被解决方案内的类库项目引用、WPF启动项目未直接安装该NuGet包，SDK风格项目用PackageReference管理依赖时，会存在间接依赖不拷贝到启动项目输出目录的问题。直接在启动项目上安装同版本的Syncfusion.SfGrid.WPF包即可，或在包管理器控制台选中启动项目为默认项目，执行Update-Package Syncfusion.SfGrid.WPF -reinstall强制修复引用和拷贝规则。
• 检查绑定重定向配置
  打开启动项目输出目录下的[启动项目名].exe.config文件，查看<runtime><assemblyBinding>节点下的Syncfusion相关绑定规则：如果存在指向不存在版本的重定向、公钥标记写错的规则，直接删除所有Syncfusion相关的<dependentAssembly>节点，卸载项目编辑csproj文件，确认存在以下两个配置项后重新生成，让VS自动生成正确的绑定重定向：

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

• 排查XAML命名空间引用错误
  WPF的XAML解析加载程序集时机早于普通托管代码，若XAML内的xmlns映射写死了强名称版本号，会导致CLR仅查找指定版本的程序集，忽略目录下的其他版本。Syncfusion WPF控件的正确命名空间引用不需要带版本、公钥信息，格式如下即可：

  xmlns:syncfusion="http://schemas.syncfusion.com/wpf"
  

  检查所有XAML文件，删除带版本、公钥标记的Syncfusion命名空间映射。
• 排查GAC残留与依赖缺失
  强命名程序集加载时会优先检索全局程序集缓存（GAC），如果之前通过MSI安装过Syncfusion控件，GAC内残留的旧版本、不完整版本会导致加载失败。打开VS开发者命令提示符，执行gacutil /l Syncfusion.SfGrid.WPF查看GAC内是否存在该程序集，若有则执行gacutil /u Syncfusion.SfGrid.WPF卸载所有GAC内的相关版本。
  另外注意：该异常不代表一定缺失SfGrid本身的dll，SfGrid依赖的Syncfusion.Shared.WPF、Syncfusion.Tools.WPF等基础dll缺失时，也会抛出同样的异常提示，重新安装NuGet包即可修复依赖拷贝问题。

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