.NET Core开发实战(第22课:异常处理中间件:区分真异常与逻辑异常)--学习笔记(下)...
接下來介紹使用代理方法的方式,也就是說把 ErrorController 整段邏輯直接定義在注冊的地方,使用一個匿名委托來處理,這里的邏輯與之前的邏輯是相同的
app.UseExceptionHandler(errApp => {errApp.Run(async context =>{// 在 Features 里面獲取異常var exceptionHandlerPathFeature = context.Features.Get<IExceptionHandlerPathFeature>();// 識別異常是否為 IKnownExceptionIKnownException knownException = exceptionHandlerPathFeature.Error as IKnownException;if (knownException == null){// 如果不是則記錄并且把錯誤的響應碼響應成 Http 500var logger = context.RequestServices.GetService<ILogger<MyExceptionFilterAttribute>>();logger.LogError(exceptionHandlerPathFeature.Error, exceptionHandlerPathFeature.Error.Message);knownException = KnownException.Unknown;context.Response.StatusCode = StatusCodes.Status500InternalServerError;}else{// 如果捕獲到的是一個業務邏輯的異常,Http 響應碼應該給是 200knownException = KnownException.FromKnownException(knownException);context.Response.StatusCode = StatusCodes.Status200OK;}// 然后再把響應信息通過 json 的方式輸出出去var jsonOptions = context.RequestServices.GetService<IOptions<JsonOptions>>();context.Response.ContentType = "application/json; charset=utf-8";await context.Response.WriteAsync(System.Text.Json.JsonSerializer.Serialize(knownException, jsonOptions.Value.JsonSerializerOptions));}); });為什么對于未知的異常要輸出 Http 500,而對于業務邏輯的異常,建議輸出 Http 200?
因為監控系統實際上會對 Http 的響應碼進行識別,當監控系統識別到 Http 響應是 500 的比例比較高的情況下,會認為系統的可用性有問題,這個時候告警系統就會發出警告
對于已知的業務邏輯的這種正常的識別的話,用正常的 Http 200 來處理是一個正常的行為,這樣就可以讓監控系統更好的工作,正確的識別出系統的一些未知的錯誤信息,錯誤的告警,讓告警系統更加的靈敏,也避免了業務邏輯的異常干擾告警系統
接下來看一下第三種,通過異常過濾器的方式
這種方式實際上是作用在 MVC 的整個框架的體系下面的,它并不是在中間件的最早期發生作用的,它是在 MVC 的整個生命周期里面發生作用,也就是說它只能工作在 MVC Web API 的請求周期里面
首先自定義一個 MyExceptionFilter
namespace ExceptionDemo.Exceptions {public class MyExceptionFilter : IExceptionFilter{public void OnException(ExceptionContext context){IKnownException knownException = context.Exception as IKnownException;if (knownException == null){var logger = context.HttpContext.RequestServices.GetService<ILogger<MyExceptionFilterAttribute>>();logger.LogError(context.Exception, context.Exception.Message);knownException = KnownException.Unknown;context.HttpContext.Response.StatusCode = StatusCodes.Status500InternalServerError;}else{knownException = KnownException.FromKnownException(knownException);context.HttpContext.Response.StatusCode = StatusCodes.Status200OK;}context.Result = new JsonResult(knownException){ContentType = "application/json; charset=utf-8"};}} }處理邏輯與之前的相同
接著注冊 Filters
services.AddMvc(mvcOptions => {mvcOptions.Filters.Add<MyExceptionFilter>(); }).AddJsonOptions(jsonoptions => {jsonoptions.JsonSerializerOptions.Encoder = System.Text.Encodings.Web.JavaScriptEncoder.UnsafeRelaxedJsonEscaping; });啟動程序,輸出如下:
{"message":"未知錯誤","errorCode":9999,"errorData":null}輸出與之前的一致,因為這是在 Controller 里面輸出了錯誤
如果在 MVC 的中間件之前輸出錯誤的話,它是沒辦法處理的
這個場景一般情況下是指需要對 Controller 進行特殊的異常處理,而對于中間件整體來講的話,又要用另一種特殊的邏輯來處理的時候,可以用 ExceptionFilter 的方式處理
這種方式還可以通過 Attribute 的方式
自定義一個 MyExceptionFilterAttribute
namespace ExceptionDemo.Exceptions {public class MyExceptionFilterAttribute : ExceptionFilterAttribute{public override void OnException(ExceptionContext context){IKnownException knownException = context.Exception as IKnownException;if (knownException == null){var logger = context.HttpContext.RequestServices.GetService<ILogger<MyExceptionFilterAttribute>>();logger.LogError(context.Exception, context.Exception.Message);knownException = KnownException.Unknown;context.HttpContext.Response.StatusCode = StatusCodes.Status500InternalServerError;}else{knownException = KnownException.FromKnownException(knownException);context.HttpContext.Response.StatusCode = StatusCodes.Status200OK;}context.Result = new JsonResult(knownException){ContentType = "application/json; charset=utf-8"};}} }在 Controller 上面標注 MyExceptionFilter
[MyExceptionFilter] public class WeatherForecastController : ControllerBase啟動運行之后效果相同
這兩種方式的效果是對等的,區別在于說可以更細粒度的對異常處理進行控制,可以指定部分的 Controller 或者 Exception,來決定我們的異常處理,也可以在全局注冊 ExceptionFilter
當然因為 ExceptionFilterAttribute 也實現了 IExceptionFilter,所以它也可以注冊到全局,也可以把它當作全局異常處理的過濾器來使用,Controller 上面也就不需要標記了
注冊 Filters
services.AddMvc(mvcOptions => {//mvcOptions.Filters.Add<MyExceptionFilter>();mvcOptions.Filters.Add<MyExceptionFilterAttribute>(); }).AddJsonOptions(jsonoptions => {jsonoptions.JsonSerializerOptions.Encoder = System.Text.Encodings.Web.JavaScriptEncoder.UnsafeRelaxedJsonEscaping; });在 Controller 上面取消標注 MyExceptionFilter
//[MyExceptionFilter] public class WeatherForecastController : ControllerBase啟動程序,輸出結果一致
這個場景對于我們定義一些 API,然后對 API 進行定義我們的異常處理的約定是很有幫助的
總結一下
首先我們需要定義特定的異常類或者接口,我們可以定義抽象類,也可以用接口的方式,例子中是通過接口的方式表示業務邏輯的異常
對于業務邏輯的異常,實際上需要定義全局的錯誤碼
對于未知的異常,應該輸出特定的輸出信息和錯誤碼,然后記錄完整的日志,我們不應該把系統內部的一些比如說異常堆棧這些信息輸出給用戶
對于已知的業務邏輯的異常,用 Http 200 的方式,對于未知的異常,用 Http 500 的方式,這樣可以讓監控系統更好的工作
另外一個建議就是盡量記錄所有的異常的詳細信息,以供后續對日志進行分析,也供監控系統做一些特定的監控警告
總結
以上是生活随笔為你收集整理的.NET Core开发实战(第22课:异常处理中间件:区分真异常与逻辑异常)--学习笔记(下)...的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 重新定义代理的扩展性:WebAssemb
- 下一篇: asp.net ajax控件工具集 Au