.NET Core从2.2迁移至3.1时出现AddAuthorization方法缺失错误

异常产生的核心原因 #

该MissingMethodException属于典型的跨框架版本程序集绑定不兼容问题：

• 报错触发时的方法查找逻辑，是由第三方程序集PII.Enterprise.AspNetCore.ApiStandards内部发起的
• 该第三方程序集是针对.NET Core 2.2版本编译的，它内部硬编码调用的AddAuthorization扩展方法，是.NET Core 2.2时代定义在Microsoft.Extensions.DependencyInjection命名空间下的旧版方法签名
• .NET Core 3.1对授权相关的框架程序集做了拆分重组，同名扩展方法的所在程序集、上下文绑定关系发生了变化，旧编译的第三方程序集在3.1运行时无法匹配到对应签名的方法，最终抛出找不到方法的异常。

分步解决操作 #

• 第一步：核对第三方程序集的版本兼容性
  打开NuGet包管理界面，找到PII.Enterprise.AspNetCore.ApiStandards包的元数据，确认其目标框架是否包含netcoreapp3.1的适配版本。如果该包仅提供面向.NET Core 2.2的编译版本，直接升级到厂商提供的适配3.1的对应包版本，禁止跨大版本直接引用2.2版本的程序集。
• 第二步：清理项目残留的旧版本程序集引用
  打开项目的.csproj文件，排查所有包引用，删除所有版本低于3.1的ASP.NET Core相关包引用（包括Microsoft.AspNetCore.Authorization、Microsoft.Extensions.DependencyInjection等包的2.2版本引用）。.NET Core 3.1的所有基础框架组件由共享框架统一提供，无需单独引入旧版本的同功能包，避免多版本程序集加载冲突。注意：不要尝试通过添加旧版本的2.2授权包来“补全”缺失的方法，这种操作会和3.1框架的内置组件产生更深层的版本冲突，引发更多无法排查的运行时异常。
• 第三步：修正授权服务的注册顺序
  当前ConfigureServices方法的实现存在注册逻辑错位：

  public void ConfigureServices(IServiceCollection services)
  {
      services.AddControllers();
      services.AddAuthenticationCore();
      // 此行调用第三方DLL时触发异常
      services.ConfigureAuthorizationHandler(Configuration);
  }
  

  调整注册顺序，在调用第三方授权扩展方法前，显式完成3.1版本适配的授权服务注册，避免第三方内部调用旧方法时发生绑定失败：

  public void ConfigureServices(IServiceCollection services)
  {
      services.AddControllers();
      // 显式注册适配3.1版本的授权核心服务
      services.AddAuthorization();
      // 调用第三方授权扩展逻辑
      services.ConfigureAuthorizationHandler(Configuration);
  }
  

  原代码中调用的AddAuthenticationCore()是框架底层的原子注册方法，无法替代3.1时代完整的AddAuthorization()扩展能力，也无法匹配第三方程序集期待的方法绑定关系。

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