Asp.Net Web API 异常处理经验总结-木庄网络博客

本文摘自PHP中文网，作者PHPzhong，侵删。

在上一篇教程中我为大家介绍了Web API中Filter的开发使用，其中讲到ExceptionFilter时留了一个坑：ExceptionFilter只能截获并处理Action执行过程中发生的异常，在Action执行过程之外如果出现异常，ExceptionFilter是无能为力的。

这些异常包括：

　　1、 Controller构造方法中出现的异常

　　2、 MessageHandlers中出现的异常

　　3、路由过程中出现的异常

　　4、 Body在序列化/反序列化过程中出现的异常

　　由此可以看出，ExceptionFilter只能解决ApiControler成功实例化后并执行Action期间出现的异常；为了解决这一个问题，在WEB API中除了ExceptionFilter外还引入了两个针对异常记录、处理的扩展点：

IExceptionLogger 和IExceptionHandler。

而这两个扩展是作为Web API的管道组件进行注册管理的，并且，他们有不同的分工：

IExceptionLogger作为异常日志记录组件，负责异常发生后的日志记录，他贯穿于整个Web API的生命周期中，在Web API框架里，任何一个请求周期中出现任何一个未被捕获/处理的异常都会首先进入这个异常日志记录管道进行异常Log记录，在Web API中可以注册多个IExceptionLogger实例负责不同的异常处理。

IExceptionHandler作为异常处理组件，负责异常发生后的处理工作，他处于异常处理管道的最末端，当IExceptionLogger组件进行一场记录完毕、没有相关的ExceptoinFilter进行异常处理时，才会最终调用ExceptionHandler进行异常处理，在Web API中，有且仅有一个ExceptionHandler进行异常的处理。

在Web API框架中给出了两个基类：ExceptionLogger和ExceptionHandler，在使用ExceptionLogger基类时，他提供了ShouldLog虚方法，该方法在基类中被调用，其作用在于避免同一个异常被同一个ExceptionLogger实例重复记录（如当后续的管道中该异常又被抛出，或者同一个ExceptionLogger对象不小心被注册了两次就会出现重复记录的可能）我们也能复写ShouldLog方法加入我们自己的异常记录判断逻辑以针对不同的场景进行不同的ExceptionLogger调用。如果有兴趣可以反编译一下ExceptionLogger基类看看，他使用了显示接口实现，挺有意思的一个技巧。下面我们来看一个ExceptionLogger使用的例子：

public class ErroLogger : ExceptionLogger
{        public  async Task LogAsync(ExceptionLoggerContext context, CancellationToken cancellationToken)
    {            var sb = new StringBuilder();            //获取Log组件
        ILogger log = LogManager.GetCurrentClassLogger();            var request = context.Request;
 
        sb.AppendLine("URL:");            //获取URL
        var url = request.RequestUri.ToString();
        sb.AppendLine(url);
        
        log.Error(context.Exception,sb.ToString(),"");
    }        public override bool ShouldLog(ExceptionLoggerContext context)
    {            return context.Exception is DemoException && base.ShouldLog(context);
    }
}