掌握 .NET 中 IExceptionHandler 的全局异常处理

一. 厌倦了处理 .NET 应用程序中分散的异常处理吗？

告别那些令人沮丧的错误日志和不可预测的崩溃。欢迎来到使用 IExceptionHandler 进行无缝、集中异常管理的世界。

二.为什么需要全局异常处理？

全局异常处理是您的安全网，可确保您的应用程序妥善处理意外错误。您可以提供清晰、一致的响应并保持良好的用户体验，而不是让用户陷入难以理解的错误消息中。

三. 介绍 IExceptionHandler 中间件

借助我们自定义的 GlobalExceptionHandlerMiddleware，管理异常从未如此简单。这款功能强大的工具可全局捕获和处理异常，确保您的应用程序运行顺畅，用户满意。

四. 主要特征

**1. 集中控制：**从一个地方管理所有异常，降低复杂性并提高可维护性。

**2. 一致的响应：**确保每个错误都得到统一处理，并通过清晰、专业的信息增强用户体验。

**3. 增强日志记录：**保留所有异常的全面日志，使调试和监控变得轻而易举。

**4. 轻松集成：**只需最少的设置即可将中间件无缝集成到您的 .NET 应用程序中。

四. 如何在你的.NET App 中实现 IExceptionHandler？

步骤 1.创建中间件

using Microsoft.AspNetCore.Diagnostics;

namespace ErrorHandlingSample
{
    // 自定义异常处理程序
    public class CustomExceptionHandler : IExceptionHandler
    {
        // 日志记录器
        private readonly ILogger<CustomExceptionHandler> logger;

        // 构造函数，初始化日志记录器
        public CustomExceptionHandler(ILogger<CustomExceptionHandler> logger)
        {
            this.logger = logger;
        }

        // 尝试异步处理异常
        public ValueTask<bool> TryHandleAsync(
            HttpContext httpContext,       // 当前 HTTP 上下文
            Exception exception,           // 捕获的异常
            CancellationToken cancellationToken)  // 用于取消操作的令牌
        {
            var exceptionMessage = exception.Message;  // 获取异常信息

            // 记录错误信息和发生时间
            logger.LogError(
                "Error Message: {exceptionMessage}, Time of occurrence {time}",
                exceptionMessage, DateTime.UtcNow);

            // 返回 false 以继续默认行为
            // - 或 - 返回 true 表示此异常已处理
            return ValueTask.FromResult(false);
        }
    }
}

步骤 2.注册中间件

using ErrorHandlingSample;

var builder = WebApplication.CreateBuilder(args);

// 添加开发人员页面异常过滤器
builder.Services.AddDatabaseDeveloperPageExceptionFilter();

// 添加 Razor Pages 服务
builder.Services.AddRazorPages();

// 注册自定义异常处理程序
builder.Services.AddExceptionHandler<CustomExceptionHandler>();

var app = builder.Build();

if (!app.Environment.IsDevelopment())
{
    // 使用异常处理程序，处理 "/Error" 路径上的错误
    app.UseExceptionHandler("/Error");

    // 启用 HTTP 严格传输安全协议 (HSTS)
    app.UseHsts();
}

// 剩余的 Program.cs 代码省略，保持简洁

五. 使用 IExceptionHandler 的好处

• **集中异常处理：**简化错误管理。
• **一致的响应：**提供统一的用户体验。
• **改进的日志记录：**轻松监控和调试问题。
• **关注点分离：**保持代码清洁且可维护。

结论

在 .NET 中使用 IExceptionHandler 实现全局异常处理将改变游戏规则。它为您的应用程序带来集中控制、一致的错误响应和增强的日志记录，从而确保提供强大且用户友好的体验。不要等待 - 立即使用这项强大的技术增强您的 .NET 应用程序！