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

ASP.NET Core 实现全局异常处理,最常用且推荐的方式是使用内置的 异常处理中间件,比如 UseExceptionHandler 和 UseDeveloperExceptionPage。它们能捕获未被 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 方法,通过 IHttpContextAccessor 或 HttpContext.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); });});
捕获特定异常并差异化响应
如果需要对不同异常类型(如 ValidationException、NotFoundException)返回不同状态码或消息,可以在自定义异常处理逻辑中做类型判断:
检查 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
微信扫一扫
支付宝扫一扫