ASP.NET Core怎么实现全局异常处理 ASP.NET Core全局异常中间件

ASP.NET Core 全局异常处理最常用方式是使用 UseExceptionHandler 和 UseDeveloperExceptionPage 中间件;前者用于所有环境并支持自定义错误响应,后者仅开发环境启用以显示详细错误页;需按顺序注册,结合日志记录与类型判断实现差异化处理。

asp.net core怎么实现全局异常处理 asp.net core全局异常中间件

ASP.NET Core 实现全局异常处理,最常用且推荐的方式是使用内置的 异常处理中间件,比如 UseExceptionHandlerUseDeveloperExceptionPage。它们能捕获未被 try-catch 拦截的异常,并统一返回友好响应,避免堆信息暴露给生产环境用户。

配置全局异常处理中间件

Program.cs(.NET 6+)中,按顺序注册异常处理中间件:

UseDeveloperExceptionPage() 仅用于开发环境,显示详细错误页(含源码、变量、调用栈) UseExceptionHandler() 用于所有环境,可指定自定义错误处理路径(如 /error)或内联委托处理异常

示例:

var app = builder.Build();if (app.Environment.IsDevelopment()){    app.UseDeveloperExceptionPage();}else{    app.UseExceptionHandler("/Error");    app.UseHsts();}app.UseHttpsRedirection();// ... 其他中间件

自定义错误处理页面或 API 响应

若使用 UseExceptionHandler("/Error"),需确保有对应端点(如 MVC 的 Error Action 或 Minimal API 路由)来接收并处理异常上下文:

MVC 中可在 Controllers/SharedController.cs 添加 Error 方法,通过 IHttpContextAccessorHttpContext.Features.Get() 获取异常详情 API 场景下更推荐用内联委托直接返回 JSON 错误响应,例如:

app.UseExceptionHandler(errorApp =>{    errorApp.Run(async context =>    {        context.Response.StatusCode = StatusCodes.Status500InternalServerError;        context.Response.ContentType = "application/json";        var feature = context.Features.Get();        var ex = feature?.Error;        var response = new        {            error = "An unexpected error occurred.",            detail = ex?.Message,            traceId = context.TraceIdentifier        };        await context.Response.WriteAsJsonAsync(response);    });});

捕获特定异常并差异化响应

如果需要对不同异常类型(如 ValidationExceptionNotFoundException)返回不同状态码或消息,可以在自定义异常处理逻辑中做类型判断:

检查 feature.Error is ValidationException vEx,返回 400 并附带验证失败字段 判断是否为自定义业务异常(如继承自 BusinessException),提取 ErrorCode 或 UserMessage 注意:中间件捕获的是“未处理异常”,所以 Controller 层已 catch 并 handled 的异常不会到达这里

日志记录与监控集成

全局异常处理是记录错误日志的关键入口:

UseExceptionHandler 委托中注入 ILogger,记录异常详情和请求上下文(如 URL、Method、User ID) 结合 Serilog、Application Insights 等工具,自动上报异常指标和追踪链路 避免在日志中打印敏感数据(如密码、Token),建议脱敏后再记录

基本上就这些。合理配置 UseExceptionHandler 就能覆盖绝大多数场景,再配合结构化日志和前端友好的错误响应,全局异常处理就稳了。

以上就是ASP.NET Core怎么实现全局异常处理 ASP.NET Core全局异常中间件的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1442870.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年12月17日 19:28:19
下一篇 2025年12月10日 04:37:59

相关推荐

发表回复

登录后才能评论
关注微信