升级.NET Core 2.1到.NET 5.0报错：IApplicationBuilder无UseDatabaseErrorPage定义

问题描述 #

将现有项目从.NET Core 2.1升级到.NET 5.0时，出现如下编译错误：

'IApplicationBuilder' does not contain a definition for 'UseDatabaseErrorPage' and no accessible extension method 'UseDatabaseErrorPage' accepting a first argument of type 'IApplicationBuilder' could be found (are you missing a using directive or an assembly reference?)

根因说明 #

UseDatabaseErrorPage方法已在ASP.NET Core 3.0及更高版本被标记为过时，.NET 5.0默认框架包中已经移除了该方法的相关实现，官方原始公告给出的适配方案无法直接在.NET 5.0环境生效。

可行解决方案 #

• 方案1：移除过时调用（优先选择）
  若不需要专属的数据库错误诊断页，直接删除Startup.cs（或采用顶层语句的Program.cs）中的app.UseDatabaseErrorPage();代码行即可，不会影响业务正常运行。开发环境下可通过app.UseDeveloperExceptionPage();覆盖包含数据库异常在内的全场景错误诊断需求。
• 方案2：手动引入兼容包（需保留原有功能时选择）
  若必须保留数据库错误页功能，手动安装NuGet包Microsoft.AspNetCore.Diagnostics.EntityFrameworkCore，选择匹配.NET 5.0的兼容版本即可，安装完成后在代码头部添加using Microsoft.AspNetCore.Builder;引用即可正常调用该方法。
• 方案3：替换为自定义异常处理逻辑
  可以自行开发异常中间件捕获数据库相关异常，实现更灵活的错误提示逻辑，示例代码如下：

  app.UseExceptionHandler(builder =>
  {
      builder.Run(async context =>
      {
          var exceptionFeature = context.Features.Get<IExceptionHandlerPathFeature>();
          if (exceptionFeature?.Error is DbUpdateException || exceptionFeature?.Error is DbException)
          {
              context.Response.StatusCode = StatusCodes.Status500InternalServerError;
              // 此处可替换为自定义错误页跳转逻辑
              await context.Response.WriteAsync("数据库操作异常，请检查连接配置、数据合法性或迁移状态");
          }
      });
  });
  

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