.NET中如何处理和捕获全局异常_全局异常处理捕获方案

使用AppDomain.UnhandledException捕获.NET Framework未处理异常;2. WPF/WinForms监听DispatcherUnhandledException处理UI线程异常;3. ASP.NET Core通过UseExceptionHandler中间件统一处理并返回结构化错误;4. 结合IHostedService或过滤器增强后台任务异常管理;核心是确保异常可记录、可追踪、不影响用户体验。

在 .NET 应用程序中,全局异常处理是保障程序稳定运行的重要机制。即使代码中存在未被显式捕获的异常,通过合理的全局异常捕获方案,也能记录错误、避免程序崩溃,并提供友好的用户反馈。以下是常见且有效的全局异常处理策略。

1. 使用 AppDomain.UnhandledException(适用于 .NET Framework)

对于传统的 .NET Framework 桌面或服务应用,AppDomain.UnhandledException 是捕获未处理异常的第一道防线。

它可以捕获当前应用程序域中未被 try-catch 捕获的异常,但注意:该事件触发后,程序通常仍会终止。

示例代码:

AppDomain.CurrentDomain.UnhandledException += (sender, e) =>
{
    var exception = (Exception)e.ExceptionObject;
    // 记录日志
    Console.WriteLine($"未处理异常: {exception.Message}");
    Console.WriteLine(exception.StackTrace);
    // 可在此发送错误报告或写入日志文件
};

2. WPF/WinForms 中的 Dispatcher 异常处理

在 WPF 或 WinForms 应用中,UI 线程抛出的异常不会触发 AppDomain 的全局事件,需监听 DispatcherUnhandledException

通过设置 e.Handled = true,可防止程序立即退出。

WPF 示例:

Application.Current.DispatcherUnhandledException += (sender, e) =>
{
    // 记录异常信息
    LogError(e.Exception);
    // 标记已处理,避免程序崩溃(但不推荐长期继续运行)
    e.Handled = true;
};

3. ASP.NET Core 全局异常中间件

在 ASP.NET Core 中,推荐使用 UseExceptionHandler 中间件来统一处理未捕获的异常。

它能捕获控制器、服务等层面抛出的异常,并返回结构化错误响应。

配置方式:

app.UseExceptionHandler(options =>
{
    options.Run(async context =>
    {
        context.Response.StatusCode = 500;
        context.Response.ContentType = "application/json";
        var ex = context.Features.Get()?.Error;
        await context.Response.WriteAsync(new
        {
            error = "服务器内部错误",
            message = ex?.Message
        }.ToString());
    });
});

也可结合 ILogger 记录详细堆栈信息。

4. 使用 IHostedService 或全局过滤器增强异常管理

在后台服务或复杂应用中,可通过自定义中间件、异常过滤器或宿主服务封装执行逻辑。

例如,在关键任务执行时使用 try-catch 包裹,并统一上报:

try
{
    await DoWork();
}
catch (Exception ex)
{
    logger.LogError(ex, "后台任务执行失败");
    // 可触发告警或重试机制
}

基本上就这些。根据项目类型选择合适的全局异常捕获方式,核心原则是:确保异常不丢失、有日志可查、不影响用户体验。合理组合多种机制,才能构建健壮的 .NET 应用。