首页 > 极客资料 博客日记
(系列六).net8 全局异常捕获机制
2024-10-12 16:30:02极客资料围观18次
说明
该文章是属于OverallAuth2.0系列文章,每周更新一篇该系列文章(从0到1完成系统开发)。
该系统文章,我会尽量说的非常详细,做到不管新手、老手都能看懂。
说明:OverallAuth2.0 是一个简单、易懂、功能强大的权限+可视化流程管理系统。
友情提醒:本篇文章是属于系列文章,看该文章前,建议先看之前文章,可以更好理解项目结构。
有兴趣的朋友,请关注我吧(*^▽^*)。
关注我,学不会你来打我
为什么要用全局异常捕获?
对于一个系统来说,全局异常捕获是必不可少的,它不仅可以把异常信息精简后反馈给用户,还能帮助程序员减少解决问题的时间,以及记录系统中任何一处发生异常的信息。
你是否依然有以下苦恼?
你是否还在为怎么记录系统异常日志而苦恼?
你是否还在为系统报错位置和报错信息苦恼?
你是否还在每个接口处增加日志记录操作?
如果你有,那么本篇文章正好可以解决你的难题。
什么是全局异常捕获机制?
全局异常捕获,顾名思义就是系统无论在那个位置发生错误都会被捕获,从而进行处理。
创建接口返回模型
创建一个接口返回模型:ReceiveStatus.cs
它的主要作用是把接口返回的数据、信息推送给前端。
/// <summary> /// 接口返回实体模型 /// </summary> public class ReceiveStatus { /// <summary> /// 编码 /// </summary> public CodeStatuEnum code { get; set; } /// <summary> /// 信息 /// </summary> public string msg { get; set; } /// <summary> /// 是否成功 /// </summary> public bool success { get; set; } /// <summary> /// 构造函数 /// </summary> public ReceiveStatus() { code = CodeStatuEnum.Successful; success = true; msg = "操作成功"; } } /// <summary> /// 接口返回结果集 /// </summary> /// <typeparam name="T"></typeparam> public class ReceiveStatus<T> : ReceiveStatus { /// <summary> /// 数据 /// </summary> public List<T> data { get; set; } /// <summary> /// 总数量 /// </summary> public int total { get; set; } }
CodeStatuEnum.cs枚举值如下
/// <summary> /// 代码状态枚举 /// </summary> public enum CodeStatuEnum { /// <summary> /// 操作成功 /// </summary> Successful = 200, /// <summary> /// 警告 /// </summary> Warning = 99991, /// <summary> /// 操作引发错误 /// </summary> Error = 99992 }
创建好接口返回模型后,我们创建一个异常帮助类,它的主要用途,是区分【系统异常】还是用户自定义的【业务异常】。
/// <summary> /// 异常帮助类 /// </summary> public class ExceptionHelper { /// <summary> /// 自定义异常(会写入错误日志表) /// </summary> /// <param name="msg"></param> public static void ThrowBusinessException(string msg) { throw new Exception(msg); } /// <summary> /// 自定义业务异常(不会写入错误日志表) /// </summary> /// <param name="msg">信息信息</param> /// <param name="codeStatu">异常状态</param> /// <returns>返回结果集</returns> public static ReceiveStatus CustomException(string msg, CodeStatuEnum codeStatu = CodeStatuEnum.Warning) { ReceiveStatus receiveStatus = new(); receiveStatus.code = codeStatu; receiveStatus.msg = msg; receiveStatus.success = false; return receiveStatus; } } /// <summary> /// 异常帮助类(返回数据) /// </summary> /// <typeparam name="T"></typeparam> public class ExceptionHelper<T> : ExceptionHelper { /// <summary> /// 自定义业务异常(不会写入错误日志表) /// </summary> /// <param name="msg">信息信息</param> /// <param name="codeStatu">异常状态</param> /// <returns>返回结果集</returns> public static ReceiveStatus<T> CustomExceptionData(string msg, CodeStatuEnum codeStatu = CodeStatuEnum.Warning) { ReceiveStatus<T> receiveStatus = new(); receiveStatus.code = codeStatu; receiveStatus.msg = msg; receiveStatus.success = false; receiveStatus.data = new System.Collections.Generic.List<T>(); return receiveStatus; } }
创建全局异常捕获中间件
在wenApi启动项目中创建一个类:ExceptionPlugIn.cs
它的主要作用就是捕获系统中发生异常对代码和记录异常日志。
它需要继承一个接口:IAsyncExceptionFilter
/// <summary> /// 全局异常捕获中间件 /// </summary> public class ExceptionPlugIn : IAsyncExceptionFilter { /// <summary> /// 全局异常捕获接口 /// </summary> /// <param name="context"></param> /// <returns></returns> public Task OnExceptionAsync(ExceptionContext context) { //异常信息 Exception ex = context.Exception; //异常位置 var DisplayName = context.ActionDescriptor.DisplayName; //异常行号 int lineNumber = 0; const string lineSearch = ":line "; var index = ex.StackTrace.LastIndexOf(lineSearch); if (index != -1) { var lineNumberText = ex.StackTrace.Substring(index + lineSearch.Length); lineNumber = Convert.ToInt32(lineNumberText.Substring(0, lineNumberText.IndexOf("\r\n"))); } // 如果异常没有被处理则进行处理 if (context.ExceptionHandled == false) { string exceptionMsg = "错误位置:" + DisplayName + "\r\n" + "错误行号:" + lineNumber + "\r\n" + "错误信息:" + ex.Message; // 定义返回类型 var result = new ReceiveStatus<string> { code = CodeStatuEnum.Error, msg = "错误信息:" + exceptionMsg, success = false, }; context.Result = new ContentResult { // 返回状态码设置为200,表示 StatusCode = StatusCodes.Status500InternalServerError, // 设置返回格式 ContentType = "application/json;charset=utf-8", Content = JsonConvert.SerializeObject(result) }; //记录日志 } // 设置为true,表示异常已经被处理了 context.ExceptionHandled = true; return Task.CompletedTask; } }
可以在OnExceptionAsync方法中添加记录日志、异常类型、异常分析等代码。
添加到服务中
编写好异常捕获机制后,我们需要把该类添加到Program.cs的服务中
//自定义全局异常处理 builder.Services.AddControllers(a => { a.Filters.Add(typeof(ExceptionPlugIn)); });
测试全局异常捕获机制
添加一个异常测试接口
运行测试
以上就是全局异常捕获机制,感兴趣的可以下载项目,修改吧。
源代码地址:https://gitee.com/yangguangchenjie/overall-auth2.0-web-api
预览地址:http://139.155.137.144:8880/swagger/index.html
帮我Star,谢谢。
有兴趣的朋友,请关注我微信公众号吧(*^▽^*)。
关注我:一个全栈多端的宝藏博主,定时分享技术文章,不定时分享开源项目。关注我,带你认识不一样的程序世界
标签:
相关文章
最新发布
- Nuxt.js 应用中的 prerender:routes 事件钩子详解
- 【问题解决】Tomcat由低于8版本升级到高版本使用Tomcat自带连接池报错无法找到表空间的问题
- 【FAQ】HarmonyOS SDK 闭源开放能力 —Vision Kit
- 六、Spring Boot集成Spring Security之前后分离认证流程最佳方案
- 《JVM第7课》堆区
- .NET 8 高性能跨平台图像处理库 ImageSharp
- 还在为慢速数据传输苦恼?Linux 零拷贝技术来帮你!
- 刚毕业,去做边缘业务,还有救吗?
- 如何避免 HttpClient 丢失请求头:通过 HttpRequestMessage 解决并优化
- 让性能提升56%的Vue3.5响应式重构之“版本计数”