从NServiceBus 7升级至8后单元测试失败，遇类型加载异常

问题原因 #

这个异常是由于NServiceBus.Core与NServiceBus.Testing版本不匹配，或者项目中残留了旧版本的NServiceBus依赖，导致测试代码调用时无法找到已移除/迁移的类型IMessageProcessingContextExtensions。

解决方案 #

• 统一所有项目的NServiceBus包版本
  确保主应用项目和测试项目的NServiceBus.Core都升级到8.x版本（与NServiceBus.Testing 8.1.0兼容，建议使用8.0及以上的匹配版本）。打开NuGet包管理器，检查所有NServiceBus相关包的版本，将不一致的版本统一更新。

• 清理缓存与项目输出
  执行以下命令清理本地NuGet缓存：

  dotnet nuget locals all --clear
  

  手动删除所有项目的bin和obj文件夹，然后重新构建整个解决方案，避免旧版本的编译文件干扰。

• 检查处理程序代码中的旧API依赖
  NServiceBus 8移除了部分IMessageProcessingContext的扩展方法，若你的消息处理程序中使用了这类旧扩展，需要替换为NServiceBus 8的原生API。例如，原扩展方法可能已整合到IMessageHandlerContext的内置方法中，直接调用即可。

• 验证TestableMessageHandlerContext的使用
  确保测试代码中导入的是NServiceBus.Testing命名空间下的TestableMessageHandlerContext，避免引用旧版本的类型。正确示例：

  using NServiceBus.Testing;
  
  [Test]
  public async Task YourHandlerTest()
  {
      var context = new TestableMessageHandlerContext();
      var handler = new YourMessageHandler();
      await handler.Handle(new YourTestMessage(), context);
  
      // 后续断言逻辑
  }
  

• .NET Framework项目需检查绑定重定向
  若使用.NET Framework，确保测试项目的app.config中配置了正确的绑定重定向，将所有旧版本的NServiceBus.Core指向8.x版本：

  <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <dependentAssembly>
          <assemblyIdentity name="NServiceBus.Core" publicKeyToken="9fc386479f8a226c" culture="neutral" />
          <bindingRedirect oldVersion="0.0.0.0-8.0.0.0" newVersion="8.0.0.0" />
      </dependentAssembly>
    </assemblyBinding>
  </runtime>
  

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