ASP.NET Core中实现全局异常拦截的完整步骤

网络编程 2025/11/8 佚名

2 0 1

蝙蝠岛资源网 Design By www.hbtsch.com

前言

异常是一种运行时错误，当异常没有得到适当的处理，很可能会导致你的程序意外终止，这篇就来讨论一下如何在 ASP.Net Core MVC 中实现全局异常处理，我会用一些样例代码和截图来说明这些概念。

全局异常处理

其实在 ASP.Net Core MVC 框架中已经有了全局异常处理的机制，你可以在一个中心化的地方使用全局异常处理中间件来进行异常拦截，如果不用这种中心化方式的话，你就只能在 Controller 或者 Action 作用域上单独处理，这会导致异常处理代码零散在项目各处，不好维护也特别麻烦，不是吗？

第二种处理全局异常的做法就是使用 exception filter，在本篇中，我准备跟大家聊一聊全局异常处理中间件和 UseExceptionHandler 方法来管控异常。

使用 UseExceptionHandler 扩展方法

UseExceptionHandler 扩展方法能够将 ExceptionHandler 中间件注册到 Asp.net Core 的请求处理管道中，然后在 IExceptionHandlerFeature 接口的实例中获取异常对象，下面的代码片段展示了如何使用 UseExceptionHandler 方法来截获全局异常。

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
 {
  app.UseExceptionHandler(builder =>
  {
   builder.Run(async context =>
  {
   context.Response.StatusCode = (int)HttpStatusCode.InternalServerError;
   context.Response.ContentType = "application/json";

   var exception = context.Features.Get<IExceptionHandlerFeature>();
   if (exception != null)
   {
   var error = new ErrorMessage()
   {
    Stacktrace = exception.Error.StackTrace,
    Message = exception.Error.Message
   };
   var errObj = JsonConvert.SerializeObject(error);

   await context.Response.WriteAsync(errObj).ConfigureAwait(false);
   }
  });
  }
  );


  app.UseStaticFiles();
  app.UseRouting();
  app.UseAuthorization();

  app.UseEndpoints(endpoints =>
  {
  endpoints.MapControllerRoute(
   name: "default",
   pattern: "{controller=Home}/{action=Index}/{id");
  });
 }

下面是代码中引用的 ErrorMessage 类的定义。

public class ErrorMessage
 {
 public string Message { get; set; }
 public string Stacktrace { get; set; }
 }

配置全局异常中间件

大家都知道，ASP.Net Core MVC 项目中都会有一个 Startup.cs 文件，可以在 Configure 方法下配置全局异常拦截中间件代码，如下所示：

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
 {
  if (env.IsDevelopment())
  {
  app.UseDeveloperExceptionPage();
  }
  else
  {
  app.UseExceptionHandler("/Error");
  }
  app.UseStaticFiles();
  app.UseCookiePolicy();
  app.UseMvc(routes =>
  {
  routes.MapRoute(
   name: "default",
   template:
   "{controller=Home}/{action=Index}/{id");
  });
 }

可以着重看一下上面的 app.UseExceptionHandler("/Error"); ，这里的 UseExceptionHandler 实现了 pipeline 注册，一旦应用程序出现了未处理异常，那么会自动将用户导向 /Error 页面。

你可以用 UseStatusCodePagesWithReExecute 扩展方法给 pipeline 添加一些状态码页面，这是什么意思呢？其实也就是 http 500 导向 500 页面， http 404 导向 404 页面，下面的代码片段展示了修改后的 Configure 方法代码。

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
 {
  if (env.IsDevelopment())
  {
  app.UseDeveloperExceptionPage();
  }
  else
  {
  app.UseExceptionHandler("/Error");
  app.UseStatusCodePagesWithReExecute("/Error/NotFound/{0}");
  }
  
  //Other code
 }

使用 ErrorController

在 HomeController 下有一个专门处理错误的 action 方法，这里我们不使用这个 action，你可以把它删掉，接下来我准备定义一个专门的 ErrorController，里面包含了一个路由为 /Error 的 action 方法。

public class ErrorController : Controller
 {
 [HttpGet("/Error")]
 public IActionResult Index()
 {
  IExceptionHandlerPathFeature iExceptionHandlerFeature = HttpContext.Features.Get<IExceptionHandlerPathFeature>();

  if (iExceptionHandlerFeature != null)
  {
  string path = iExceptionHandlerFeature.Path;
  Exception exception = iExceptionHandlerFeature.Error;

  //Write code here to log the exception details
  return View("Error",iExceptionHandlerFeature);
  }  
  return View();
 }

 [HttpGet("/Error/NotFound/{statusCode}")]
 public IActionResult NotFound(int statusCode)
 {
  var iStatusCodeReExecuteFeature =HttpContext.Features.Get<IStatusCodeReExecuteFeature>();
  return View("NotFound",iStatusCodeReExecuteFeature.OriginalPath);
 }
 }

你可以用 IExceptionHandlerPathFeature 来获取异常相关信息，也可以用 IStatusCodeReExecuteFeature 来获取 http 404 异常时当时的请求路径，对了，要想用上 IExceptionHandlerPathFeature 和 IStatusCodeReExecuteFeature ,要记得在 nuget 上安装了 Microsoft.AspNetCore.Diagnostics 包，下面的代码展示了如何获取异常发生时刻的路由地址。

string route = iExceptionHandlerFeature.Path;

如果想获取异常的详细信息，可以使用如下语句。

var exception = HttpContext.Features.Get<IExceptionHandlerPathFeature>();

一旦获取了这个路由地址和异常的详细信息，就可以将它记录到你的日志文件中，可供后续仔细分析。

使用 View 展示错误信息

可以创建一个 View 来展示出现的错误信息，下面时 Error ViewPage 的详细代码。

@model Microsoft.AspNetCore.Diagnostics.IExceptionHandlerFeature
@{
 ViewData["Title"] = "Index";
 Layout = "~/Views/Shared/_Layout.cshtml";
}
<div class="row">
 <div class="text-danger">
  <h3>Error: @Model.Error.Message</h3>
 </div>
</div>
<div class="row">
 <div class="col-12">
  <p>@Model.Error.StackTrace</p>
  <p>@Model.Error.InnerException</p>
 </div>
</div>

下面是 NotFound 页面的代码

@model string
@{
 ViewData["Title"] = "NotFound";
 Layout = "~/Views/Shared/_Layout.cshtml";
}
 <h1 class="text-danger">
 Error: The requested URL @Model was not found!</h1>
<hr />

现在可以把程序跑起来了，你会看到如下的错误信息。

如果你尝试打开一个不存在的页面，会自动跳转到 ErrorController.NotFound 所包装的 404 描述信息。

ASP.NET Core 中内置了全局异常处理，你可以利用这项技术在一个集中化的地方去截获你应用程序中的所有异常信息，当然你也可以基于环境的不同采取不用的异常处理措施，比如说：开发环境，测试环境，生产环境等等。

译文链接： https://www.infoworld.com/art...

更多高质量干货：参见我的 GitHub:dotnetfly

asp.net,core全局异常拦截,asp.netcore,异常

标签：

asp.net,core全局异常拦截,asp.netcore,异常

蝙蝠岛资源网 Design By www.hbtsch.com

广告合作：本站广告合作请联系QQ：858582 申请时备注：广告合作（否则不回）
免责声明：本站文章均来自网站采集或用户投稿，网站不提供任何软件下载或自行开发的软件！如有用户或公司发现本站内容信息存在侵权行为，请邮件告知！ 858582#qq.com

蝙蝠岛资源网 Design By www.hbtsch.com

评论“ASP.NET Core中实现全局异常拦截的完整步骤”

暂无ASP.NET Core中实现全局异常拦截的完整步骤的评论...

www.hbtsch.com 蝙蝠岛资源网

139,976影音资源

144,792福利资源

21,817软件资源

631,128技术资源

ASP.NET Core中实现全局异常拦截的完整步骤

前言

全局异常处理

使用 UseExceptionHandler 扩展方法

配置全局异常中间件

使用 ErrorController

使用 View 展示错误信息

asp.net,core全局异常拦截,asp.netcore,异常

asp.net core集成CKEditor实现图片上传功能的示例代码

ASP.NET Core Controller与IOC结合问题整理

评论“ASP.NET Core中实现全局异常拦截的完整步骤”

RTX 5090要首发性能要翻倍！三星展示GDDR7显存

更新日志

友情链接

ASP.NET Core中实现全局异常拦截的完整步骤

前言

全局异常处理

使用 UseExceptionHandler 扩展方法

配置 全局异常中间件

使用 ErrorController

使用 View 展示错误信息

asp.net,core全局异常拦截,asp.netcore,异常

asp.net core集成CKEditor实现图片上传功能的示例代码

ASP.NET Core Controller与IOC结合问题整理

评论“ASP.NET Core中实现全局异常拦截的完整步骤”

RTX 5090要首发 性能要翻倍！三星展示GDDR7显存

更新日志

友情链接

配置全局异常中间件

RTX 5090要首发性能要翻倍！三星展示GDDR7显存