ASP.NET MVC中异常处理&自定义错误页详析
更新时间：2018年04月21日 11:28:01 作者：chenxin.dm
当ASP.NET MVC程序出现了异常，怎么处理更加规范？下面这篇文章主要给大家介绍了关于ASP.NET MVC中异常处理&自定义错误页的相关资料，文中通过示例代码介绍的非常详细，需要的朋友可以参考借鉴，下面来一起学习学习吧。
一、应用场景
对于B/S应用程序,在部署到正式环境运行的过程中,很有可能出现一些在前期测试过程中没有发现的一些异常或者错误,或者说只有在特定条件满足时才会发生的一些异常,对于使用ASP.NET MVC开发的应用程序站点，在部署到IIS上后，如果开发人员未对程序进行错误处理,那么一旦程序出现未处理的错误或异常,用户将看到一个让人感到及其困惑的错误堆栈跟踪页面,使得站点的用户体验下降,从程序的角度上来说,不做自定义错误处理也不利于程序出问题时的根源查找,因为很多时候有些错误只在特定条件下满足时才重现,一旦错过,可能就需要花大量时间去测试来重现问题,如果此时开发人员有对程序中的运行时异常进行日志记录,那么或许将提供一些有价值的错误根源信息,下面我将向下大家讲解如何实现自定义异常处理并跳转到友好的错误提示页面。
二、异常处理&自定义错误页
1、通过异常过滤器 实现异常处理和自定义错误页
asp.net mvc 提供了 异常过滤器 的方式来实现当执行controller中某个action方法时抛出了未处理的异常时的捕捉,mvc中的异常过滤器是以特性(Attribute)的形式存在的，定义一个自定义异常过滤器只需要两个步骤：
1、定义一个类,继承FilterAttribute类,并实现IExceptionFilter接口 2、应用自定义异常过滤器至指定的 action方法 或 controller类 或 全局应用。
异常过滤器代码
using log4net;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.Mvc;
namespace Blog20180413.Filters
{
public class CustomExceptionFilterAttribute : FilterAttribute, IExceptionFilter
{
//log4net组件,用于日志记录。
static readonly ILog log = LogManager.GetLogger(typeof(CustomExceptionFilterAttribute));
public void OnException(ExceptionContext filterContext)
{
//对捕获到的异常信息进行日志记录,方便开发人员排查问题。
log.Error("应用程序异常", filterContext.Exception);
//跳转到自定义的错误页,增强用户体验。
ActionResult result = new ViewResult() { ViewName = "CustomErrorPage" };
filterContext.Result = result;
//异常处理结束后,一定要将ExceptionHandled设置为true,否则仍然会继续抛出错误。
filterContext.ExceptionHandled = true;
}
}
}
使用异常过滤器
using Blog20180413.Filters;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.Mvc;
namespace Blog20180413.Controllers
{
public class TestExceptionHandleController : Controller
{
[CustomExceptionFilter]
public ActionResult Index()
{
string str = string.Empty;
//将抛出转换异常
int result = int.Parse(str);
return View();
}
}
}
注意：
第二个步骤中提到,可以将自定义异常过滤器 只应用到 action或者controller,如果只想将指定的异常过滤器以特性的形式应用到指定的一个或者多个controller或者action,而不想应用到所有的controller或者action,那么必须将该异常过滤器继承FilterAttribute类,这是因为mvc框架是通过FilterAttributeFilterProvider.GetFilters来获取标记在指定controller或者action上的异常过滤器特性的,而GetFilters内部逻辑要求必须继承自FilterAttribute类。
如果需要将自定义的异常过滤器应用到所有的controller的action上,那么需要将该自定义异常过滤器注册到全局，代码如下：
using Blog20180413.Filters;
using System.Web;
using System.Web.Mvc;
namespace Blog20180413
{
public class FilterConfig
{
public static void RegisterGlobalFilters(GlobalFilterCollection filters)
{
filters.Add(new CustomExceptionFilterAttribute());
}
}
}
2、通过在Global.asax 中定义Application_Error方法 实现异常处理和自定义错误页
上面提到的 自定义异常过滤器只能捕获在执行action方法过程中抛出的异常（即使注册为全局过滤器也只能捕获action方法执行过程中抛出的异常）,如果需要捕获更高级别的异常，也就是在请求执行过程中出现的任何异常（如在控制器的构造函数中抛出异常）,那么可以使用该种方式，代码如下：
using log4net;
using log4net.Config;
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Web;
using System.Web.Mvc;
using System.Web.Routing;
namespace Blog20180413
{
public class MvcApplication : System.Web.HttpApplication
{
static readonly ILog log = LogManager.GetLogger(typeof(MvcApplication));
protected void Application_Start()
{
AreaRegistration.RegisterAllAreas();
FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters);
RouteConfig.RegisterRoutes(RouteTable.Routes);
XmlConfigurator.ConfigureAndWatch(new FileInfo(Server.MapPath("~/web.config")));
}
protected void Application_Error(object sender, EventArgs e)
{
Exception exception = Server.GetLastError();
//Server.ClearError();
//这里记录错误日志信息
log.Error("MvcApplication 捕获异常", exception);
//跳转到指定的自定义错误页
Response.Redirect("/CustomErrorHandle/CustomErrorPage");
}
}
}
3、通过配置system.web->customErrors节点 实现自定义错误页
当你的站点发生异常时,如果你只是想简单的跳转到一个自定义错误页面,而不是对异常进一步处理时,那么你可以简单的作如下配置操作即可：
需要在web.config中做如下配置：
<system.web>
<customErrors mode="On" defaultRedirect="CustomErrorPage">
</customErrors>
</system.web>
注意：这里的CustomErrorPage是一个视图文件,放在Shared共享目录下。
如果你注册了HandleErrorAttribute异常过滤器到全局,那么在你的错误页中将能获取到和异常相关的一些信息。但此时配置到defaultRedirect的值的必须是Error
也就是自定义错误视图页面的名称必须为Error.cshtml,并且放在Shared目录，当然,你也可以通过在创建HandleErrorAttribute全局过滤器的过程中,设置器View属性,这样你就可以不用讲错误视图的名称设置为Error了.如下：
public static void RegisterGlobalFilters(GlobalFilterCollection filters)
{
HandleErrorAttribute errorAttribute = new HandleErrorAttribute();
errorAttribute.View = "CustomErrorPage";
filters.Add(errorAttribute);
}
注册HandleErrorAttribute（使用默认的错误视图页面文件名）
public class FilterConfig
{
public static void RegisterGlobalFilters(GlobalFilterCollection filters)
{
filters.Add(new HandleErrorAttribute());
}
}
定义Error.cshtml视图页
@{
Layout = null;
}
@model HandleErrorInfo
<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width" />
<title>Error</title>
</head>
<body>
<div>
@*通过HandleErrorAttribute异常过滤器捕获到的异常信息存储在Model属性中*@
@Model.Exception.Message
</div>
</body>
</html>
之所以通过注册HandleErrorAttribute过滤器捕获的异常在错误页中能获取异常信息可以看HandleErrorAttribute类的内部实现,发现加载错误视图页面的过程中,传递了一个HandleErrorInfo对象过去。
public virtual void OnException(ExceptionContext filterContext)
{
if (filterContext == null)
{
throw new ArgumentNullException("filterContext");
}
if (!filterContext.IsChildAction && (!filterContext.ExceptionHandled && filterContext.HttpContext.IsCustomErrorEnabled))
{
Exception innerException = filterContext.Exception;
if ((new HttpException(null, innerException).GetHttpCode() == 500) && this.ExceptionType.IsInstanceOfType(innerException))
{
string controllerName = (string) filterContext.RouteData.Values["controller"];
string actionName = (string) filterContext.RouteData.Values["action"];
HandleErrorInfo model = new HandleErrorInfo(filterContext.Exception, controllerName, actionName);
ViewResult result = new ViewResult {
ViewName = this.View,
MasterName = this.Master,
ViewData = new ViewDataDictionary<HandleErrorInfo>(model),
TempData = filterContext.Controller.TempData
};
filterContext.Result = result;
filterContext.ExceptionHandled = true;
filterContext.HttpContext.Response.Clear();
filterContext.HttpContext.Response.StatusCode = 500;
filterContext.HttpContext.Response.TrySkipIisCustomErrors = true;
}
}
}
public string View
{
get
{
if (string.IsNullOrEmpty(this._view))
{
return "Error";
}
return this._view;
}
set =>
(this._view = value);
}
三、总结
总的来说,Application_Error方法用于处理针对请求管道级别的发生的异常错误,而Mvc异常过滤器则只能处理在执行action方法过程中出现的异常.能处理的范围相对Application_Error较小，但在实际项目开发中,用Mvc异常过滤器处理异常相对会多一点,因为我们的功能业务往往体现在控制器的action方法执行的过程中,也就是在这个过程中较容易产生异常。故开发中用Mvc异常过滤器就能适应大部分的异常处理需求。
好了，以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作具有一定的参考学习价值，如果有疑问大家可以留言交流，谢谢大家对华域联盟的支持。
您可能感兴趣的文章:asp.net 错误：0x8007000B 异常的解决方法asp.net iis7默认文档错误异常的解决方法ASP.NET Core异常和错误处理（8）ASP.NET生成eurl.axd Http异常错误的处理方法ASP.NET Core应用错误处理之DeveloperExceptionPageMiddleware中间件呈现“开发者异常页面”你应该知道的.NET错误与异常处理机制
asp.net
异常
自定义错误页
相关文章
asp.net 图片超过指定大小后等比例压缩图片的方法asp.net 图片超过指定大小后等比例压缩图片的方法，需要的朋友可以参考一下 2013-05-05
asp.net中显示1至20相同数字相乘的结果，若值比50小就不显示感兴趣的网友也可以练习练习。现在Insus.NET的作答如下，但老师还没有看，因此答案是否正确或是最好的，还不能确定，只是供参考 2012-05-05
asp.net实现在XmlTextWriter中写入一个CDATA的方法这篇文章主要介绍了asp.net实现在XmlTextWriter中写入一个CDATA的方法,结合实例形式分析了XmlTextWriter写入CDATA的步骤与相关实现技巧,需要的朋友可以参考下 2016-04-04
asp.net小孔子cms中的数据添加修改最近都在看小孔子cms的代码，其添加与修改数据十分方便，做下笔记，代码主要提取自小孔子cms，去掉了不用的函数并把相关代码写到一个文件中 2008-08-08
webapi中如何使用依赖注入本篇将要和大家分享的是webapi中如何使用依赖注入，依赖注入这个东西在接口中常用，实际工作中也用的比较频繁，因此这里分享两种在api中依赖注入的方式Ninject和Unity。下面跟着小编一起来看下吧
2017-02-02
C#判断文件路径是否存在或者判断文件是否存在的方法判断文件路径是否存在的方法有很多，在本文为大家介绍下c#中时如何判断文件及文件路径是否存在，感兴趣的朋友不要错过 2013-10-10
用.NET 2.0压缩/解压功能处理大型数据用.NET 2.0压缩/解压功能处理大型数据... 2006-09-09
使用ASP.NET模板生成HTML静态页面的五种方案使用ASP.NET模版生成HTML静态页面并不是难事，主要是使各个静态页面间的关联和链接如何保持完整。本文介绍了使用ASP.NET模版生成HTML静态页面的五种方案 2011-11-11
ASP.NET Core使用GraphQL第二章之中间件这篇文章主要给大家介绍了关于ASP.NET Core使用GraphQL第二章之中间件的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧 2018-11-11
aspxgridview CustomButtonCallback 不支持弹出消息提示解决方法aspxgridveiw是devexpress的一个grid控件，使用起来还不错，不能再 CustomButtonCallback 事件中使用response.write，具体的解决方法如下，感兴趣的朋友可以参考下哈 2013-06-06
最新评论
本文由 华域联盟 原创撰写：华域联盟 » ASP.NET MVC中异常处理&自定义错误页详析
转载请保留出处和原文链接：https://www.cnhackhy.com/5585.htm
