ASP.NET MVC 默认提供了一个异常过滤器HandleError特性,使用该特性可以极为方便的捕捉并处理控制器和操作抛出的异常,也可以将此特性注册为全局异常过滤器从而捕捉项目中的所有异常。如果想要简单的消灭错误黄页(错误详细页),使用HandlerErrorAttribute是不错的选择!
本文演示项目下载地址:,项目使用的VS2013和ASP.NET MVC 5框架,项目中也拷贝了HandleErrorAttribute的源码以供参考。
HandleErrorAttribute初步使用
使用HandleErrorAttribute处理异常很简单,首先要开启Web.config配置文件中的自定义错误,因为HandleError特性是依赖自定义错误的,customErrors的Mode必须要设置为On或RemoteOnly:
到了这里基本上就成功启用了异常过滤器,因为VS2013新建的ASP.NET MVC 5项目默认将HandleError注册为全局异常过滤器,只要项目中的控制器和操作方法有抛出异常,默认就会被HandleError特性捕获,从而跳转到默认的错误详细页面~/Views/Shared/Error.cshtml。打开项目下App_Start的FilterConfig类(全局过滤器配置类),可以看到已经被注册的HandleErrorAttribute类:
public class FilterConfig{ public static void RegisterGlobalFilters(GlobalFilterCollection filters) { filters.Add(new HandleErrorAttribute()); //如果要更改默认的错误视图,需要设置View属性 //filters.Add(new HandleErrorAttribute() { View = "~/Views/Error/CustomHttpError.cshtml" }); } }
备注:关于FilterConfig类,如果不清楚的朋友可以看这篇文章:
这里可以动态抛出一些异常来进行测试,在默认的Home控制器下复制如下代码:
public class HomeController : Controller{ public ActionResult Index() { return View(); } ////// 抛出HTTP 500 /// ///public ActionResult ThrowHttp500() { throw new HttpException(500, "服务器错误"); } /// /// 抛出HTTP 404 /// ///public ActionResult ThrowHttp404() { throw new HttpException(404, "页面未找到"); } /// /// 抛出未引用对象异常 /// ,此处单独使用HandleError特性 /// ,并指定异常类型及响应视图 /// ///[HandleError(ExceptionType = typeof(NullReferenceException),View="CustomError")] public ActionResult ThrowNullReferenceException() { throw new NullReferenceException(); } /// /// 引发输入字符串的格式不正确异常 /// ,此处指定了响应的错误页面 /// ,由于是不同的控制器所以要完整的相对路径 /// ///[HandleError(View = "~/Views/Error/CustomHttpError.cshtml")] public ActionResult ThrowFormatException() { string str = ""; int count = Convert.ToInt32(str); return View("Index"); } }
备注:记得添加对应的错误视图页和控制器,建议直接下载演示项目。
首页操作演示界面如下:
灵活运用HandleError特性
HandleError特性提供了许多属性,我们可以更加灵活的处理项目中抛出的异常。文档截图:
一般来说最常用的属性是View,Order和ExceptionType,至于AllowMultiple属性,除非业务有特殊要求,不然默认都是允许的。
自定义错误信息页面
先说View属性,设置此属性就可以自定义要跳转的错误视图页,否则一旦有异常抛出,默认会跳转到Error.cshtml这个页面,该页面路径为:~/Views/Shared/Error.cshtml。
设置View属性一定要注意路径问题,如果跳转的异常信息页面属于其他控制器,即控制器路由地址不同,那么一定要用完整的相对路径,否则引发二次异常:未找到视图**或其母版视图,或没有视图引擎支持搜索的位置。,比如下面代码(此声明是在Home控制器中,但是要跳转的错误页面则是在Error控制器中):
[HandleError(View = "~/Views/Error/CustomHttpError.cshtml")]
如果跳转的异常页面是属于当前控制器,或者是属于公共视图页的,就可以直接设置视图名称,代码如下:
[HandleError(View="CustomError")]
备注:CustomError是一个公共的自定义错误信息视图页面,另外公共视图页都是放在~/Views/Shared/这个路径下。
如果不想使用默认的Error.cshtml,想将所有的异常响应跳转到自定义的异常信息视图页,那么只要通过全局过滤器配置类FilterConfig,在注册HandleErrorAttribute时设置View属性即可,代码如下:
public class FilterConfig{ public static void RegisterGlobalFilters(GlobalFilterCollection filters) { filters.Add(new HandleErrorAttribute() { View = "~/Views/Error/CustomHttpError.cshtml" }); } }
同样要注意视图路径问题,其实这里最好使用公共视图页。这里额外说下Master属性,此属性可以指定要跳转的视图页的母板。基本上很少用,除非项目业务有需要,比如动态控制母板什么的,不然的话都是在视图中直接设置好的。
获取详细的异常信息
是HandleErrorAttribute默认提供的错误信息实体
可以通过此类获取引发异常的控制器和操作方法名称,以及通过获取Exception对象获取详细的错误内容。只要在对应的视图页中声明此类即可,演示代码:
@model System.Web.Mvc.HandleErrorInfo@{ ViewBag.Title = "自定义的公共错误页面";}@section styles{ }自定义的公共错误页面
@if (Model != null) {异常类型:@Model.Exception.GetType().Name
触发异常的控制器:@Model.ControllerName
触发异常的操作方法:@Model.ActionName
错误信息:@Model.Exception.Message
页面路径:~/Views/Shared/CustomError.cshtml
}
演示的视图截图:
针对异常类型
ExceptionType属性可以让HandleError针对某种异常类型做出处理,可以搭配View属性来使用,便于跳转到不同的异常信息页面,演示代码:
[HandleError(ExceptionType = typeof(NullReferenceException),View="CustomError")]
上面代码一旦捕获到NullReferenceException异常,就会跳转到CustomError视图页。注意一点,ExceptionType需要使用typeof转化异常类型。
关于过滤器的执行顺序
如果声明了多个HandleError异常过滤器,就需要使用到Order属性设置运行顺序。Order属性默认值为-1,也是最高优先级,正常来说整数值越大优先级越低,但是由于HandleError是继承于IExceptionFilter接口,所以优先级顺序是相反的,也就是说整数值越大,优先级也就越大,这里分享下:
这里有两点需要注意:
- 如果Order属性小于-1会抛出异常,所以只能设置大于等于-1的整数值。
- 如果没有设置Order属性,由于默认值都是-1(即最高优先级),会导致过滤器的执行顺序变成无序随机。
使用HandleErrorAttribute的一些注意事项
虽然HandleError特性使用起来很简单,但是依然有很多需要注意很多地方,下面会详细的分析特性的局限性和一些缺点。
依赖于ASP.NET的自定义错误模块
如果customErrors mode="Off",则HandleError则无效,不对任何异常进行处理。
源码:
// If custom errors are disabled, we need to let the normal ASP.NET exception handler// execute so that the user can see useful debugging information.if (filterContext.ExceptionHandled || !filterContext.HttpContext.IsCustomErrorEnabled){ return;}
从源码中可以看到,当HttpContext.IsCustomErrorEnabled属性为false时(即未启用自定义错误),就不进行任何处理,直接return停止流程。
只能处理500服务器错误
像HTPP 404、401、503等错误代码,都是不处理的。源码可以很直接看出,只要不是500错误就直接return返回:
// If this is not an HTTP 500 (for example, if somebody throws an HTTP 404 from an action method),// ignore it.if (new HttpException(null, exception).GetHttpCode() != 500) { return; }
因此除了500错误,其他错误只能通过自定义错误模块配置响应的页面:
只能跳转到视图
HandleError只提供了一个View属性,所以响应的异常信息页也只能是视图,其他的静态页面或者.aspx之类的都是无法进行跳转的,可以使用自定义异常过滤器实现此功能。
跳转的原理是通过设置ExceptionContext.Result属性:
filterContext.Result = new ViewResult{ ViewName = View, MasterName = Master, ViewData = new ViewDataDictionary(model), TempData = filterContext.Controller.TempData};
不利于SEO搜索引擎优化
这里涉及到部分SEO的知识,简单来说错误页面是使用302跳转,因此对搜索引擎抓取网站内容并不友好。如果是互联网行业的网站,考虑到SEO的问题还是不要用HandleErrorAttribute处理异常,类似企业系统的网站倒是十分适合使用。
至于应对的方法可以参考此文:
同时声明多个HandleError的效果
多个HandleError最终只有一个过滤器会执行,其他的过滤器会自动停止执行,至于是哪个过滤器执行则是依靠Order属性进行优先级确定,原理是使用ExceptionContext.ExceptionHandled属性进行判断,一旦该属性为true则表示当前抛出的异常已经被其他过滤器处理了,直接return停止余下的流程。
高级进阶之继承HandleErrorAttribute实现自定义功能
通过继承HandleErrorAttribute类创建新的异常处理特性,可以使我们扩展更多的自定义功能,比如记录错误日志、发送错误信息邮件等。继承后只要重写此类中的OnException方法即可实现功能,演示代码如下:
public class CustomHandleErrorAttribute : HandleErrorAttribute{ public override void OnException(ExceptionContext filterContext) { /* 调用基类的OnException方法,实现基础的功能。 * 如果要完全的自定义,就不需要调用基类的方法 */ base.OnException(filterContext); /* 此处可进行记录错误日志,发送错误通知等操作 * 通过Exception对象和HttpException对象可获取相关异常信息。 * Exception exception = filterContext.Exception; * HttpException httpException = new HttpException(null, exception); */ } }
调用基类的OnException方法依然要注意HandleErrorAttribute类的一些限制,除非不使用基类的方法。继承后的新特性使用方法和HandleError一样,依然可以全局注册和局部使用。
如果需要完全自定义异常处理的功能,建议直接继承IExceptionFilter接口以实现功能,可以参考这篇文章:
参考资料分享
作者:
出处:
欢迎转载本文,本文版权归作者所有,转载请声明出处或保留此段声明。^_^请尊重他人劳动成果,共建美好的网络环境。