ASP.NET MVC的错误处理应考虑到这几个方面:模型绑定期间发生的错误,未能路由到指定操作,针对控制器的错误处理。使用配置文件可以帮助我们处理异常,但是不够灵活和全面;使用HandleErrorAttribute、自定义错误过滤器或重写控制器OnException方法只能解决针对控制器的错误,无法解决模型绑定期间发生的错误,也无法处理404错误,即使将错误过滤器注册为全局过滤器也是如此。有时候需要多种方法配合使用。
在捕获错误的地方,可以将有用的信息记录下来,便于我们查出引起问题的原因和纠正错误。
1启用自定义错误
使用这种方式一定要注意将defaultRedirect设置为指定的错误页面,防止黑客探测各种错误情形进而发现系统的额漏洞。
<system.web> <customErrors mode="On" defaultRedirect="/error/error2"> <error statusCode="404" redirect="/error/error1" /> </customErrors> <!--其他配置--> </system.web>
Mode:处理模式,有三种处理模式
On,启用自定义处理功能,当错误发生时显示自定义错误页
Off,关闭自定义错误处理功能,当错误发生时显示默认的错误页。
RemoteOnly,启用自定义错误处理功能,但只针对来自远程机器的请求有效。
defaultRedirect:发生错误时,显示指定错误页。
<error>:根据状态码显示指定的错误页。mode必须为On或RemoteOnly模式,否则不会起作用。
注意:不论defaultRedirect和redirect都配置为指定的路径,例如上述配置中控制器error,控制器操作为error1和error2,相应地错误页为Error1.cshtml和Error2.cshtml。
2针对控制器的错误处理
2.1使用HandleErrorAttribute修饰控制器或操作。
[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, Inherited = true, AllowMultiple = true)] public class HandleErrorAttribute : FilterAttribute, IExceptionFilter { //获取或设置异常的类型。 public Type ExceptionType { get; set; } //获取或设置用于显示异常信息的母版视图 public string Master { get; set; } //获取此特性的唯一标识符。 public override object TypeId { get; } //获取或设置用于显示异常信息的页视图。 public string View { get; set; } //在发生异常时调用。 //filterContext:操作筛选器上下文 public virtual void OnException(ExceptionContext filterContext); }
例:
当发生KeyNotFoundException类型的异常时,显示KeyNotFind视图
[HandleError(ExceptionType=typeof(KeyNotFoundException),View="KeyNotFound")] public ActionResult Index() { ...... }
还可以使用自定义的错误过滤器,并将其应用到控制器或操作上。
例:
public class CustomHandleError : HandleErrorAttribute { public override void OnException(ExceptionContext filterContext) { if (filterContext==null) base.OnException(filterContext); //记录日志 LogError(filterContext.Exception); //判断是否启用了自定义错误 if (filterContext.HttpContext.IsCustomErrorEnabled) { //将错误设置为已处理 filterContext.ExceptionHandled = true; base.OnException(filterContext); } } }
可以设置全局过滤器,这样对每一个控制器都起作用。
App_Start文件夹下FilterConfig.cs文件中设置全局错误过滤器,过滤器会按照他们注册的顺序执行。但可以通过Order属性指定执行顺序。
例:
public class FilterConfig { public static void RegisterGlobalFilters(GlobalFilterCollection filters) { filters.Add(new HandleErrorAttribute { ExceptionType = typeof(KeyNotFoundException), View = "KeyNotFound", Order = 2 }); filters.Add(new HandleErrorAttribute(),1); } }
将自定义错误过滤器设置为全局过滤器:
在App_Start文件夹下FilterConfig.cs文件中
例:
public class FilterConfig { public static void RegisterGlobalFilters(GlobalFilterCollection filters) { //其他过滤器 filters.Add(new CustomHandleError()); } }
2.2重写控制器OnException方法
注意将错误设置为已处理,不然错误继续抛出,但如果设置了全局错误过滤器,那么即使不标记为已处理,也不要紧,因为错误最终会被全局过滤器捕获并处理。
例:
public class HomeController : Controller { //其他控制器操作 protected override void OnException(ExceptionContext filterContext) { if (filterContext==null) base.OnException(filterContext); //记录日志 LogError(filterContext.Exception); //判断是否启用了自定义错误 if (filterContext.HttpContext.IsCustomErrorEnabled) { //将错误设置为已处理 filterContext.ExceptionHandled = true; //显示错误页 this.View("Error").ExecuteResult(this.ControllerContext); } } }
或者创建控制器基类
public class BaseController : Controller { protected override void OnException(ExceptionContext filterContext) { //错误日志记录 } }
3全局错误处理
针对模型绑定或路由等过程中抛出的异常我们只能使用全局错误处理策略。
3.1 Global.asax中添加处理异常的代码
例: