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

更新时间：2021年01月05日 10:21:29 作者：一线码农

这篇文章主要给大家介绍了关于ASP.NET Core中如何实现全局异常拦截的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧

前言

异常是一种运行时错误，当异常没有得到适当的处理，很可能会导致你的程序意外终止，这篇就来讨论一下如何在 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.NET Core全局异常拦截内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

ASP.NET实现按拼音码模糊查询的方法
我们在做数据录入或者查询的时候，经常需要实现按用户输入的拼音码进行数据的模糊查询功能，本文为大家介绍ASP.NET如何实现按拼音码模糊查询，需要的朋友可以参考下
2015-09-09
基于Jexus-5.6.3使用详解
下面小编就为大家分享一篇基于Jexus-5.6.3使用详解，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2018-02-02
C# GetWindowRect简介及使用说明
GetWindowRect返回指定窗口的边框矩形的尺寸。该尺寸以相对于屏幕坐标左上角的屏幕坐标给出,需要的朋友可以了解下
2012-12-12
完美兼容ie和firefox的asp.net网站加入收藏和设置主页
这篇文章主要介绍了完美兼容ie和firefox的asp.net网站加入收藏和设置主页,需要的朋友可以参考下
2014-12-12
C#调用C++版本dll时的类型转换需要注意的问题小结
最近使用C#调用C++版本的dll遇到很多类型转换的问题，现记录出容易出错的部分。
2010-04-04
OpenCms 带分页的新闻列表
有一些网友在新闻列表分页上还遇到一些问题，正好这个blog上也忘记了此部分内容，现在补充上，功能是实现了，可以自己再做些优化，OpenCms7.0.5下测试通过，内容如下(编辑器的插入代码功能有问题，就直接把代码粘上了
2008-07-07
GridView控件实现数据的显示和删除（第8节）
这篇文章主要介绍了GridView控件实现数据的显示和删除，以新闻网站为例，实现对新闻数据的操作,了解各种数据源控件与数据绑定控件的类型和作用，需要的朋友可以参考下
2015-08-08
如何在ASP.NET Core中给上传图片功能添加水印实例代码
这篇文章主要给大家介绍了关于如何在ASP.NET Core中给上传图片功能添加水印的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面来一起学习学习吧
2019-02-02
.Net弹性和瞬态故障处理库Polly介绍
这篇文章介绍了.Net弹性和瞬态故障处理库Polly，文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2022-06-06
asp.net gridview中用checkbox全选的几种实现的区别
这几天为了改变客户端grid的全选效率问题，详细研究了ext中grid的全选和gridview中通过脚本实现的全选效率，总结一下，供大家参考，有错误的地方，希望大侠指正，小弟献丑了。
2009-06-06