C#的全局异常处理是什么？如何实现？-C#.Net教程-PHP中文网

C#的全局异常处理是什么？如何实现？

煙雲

发布： 2025-09-19 08:01:01

原创

673人浏览过

C#全局异常处理通过AppDomain和TaskScheduler事件捕获未处理异常，前者用于WinForms/WPF应用，后者处理异步任务异常，结合日志记录与用户友好提示，确保程序稳定性，且不影响正常性能。

c#的全局异常处理是什么？如何实现？

C#全局异常处理，简单来说，就是为你的程序设置一个“安全网”，当程序在运行时出现未被捕获的异常时，这个“安全网”就会启动，防止程序崩溃，并允许你记录错误信息，甚至尝试恢复。

全局异常处理的核心在于捕获那些未被try-catch块处理的异常。

解决方案

实现C#全局异常处理主要有两种方式：

Application Domain级别的异常处理： 适用于桌面应用程序（WinForms, WPF）。
TaskScheduler级别的异常处理： 适用于异步操作的异常处理。

1. Application Domain级别的异常处理 (WinForms/WPF)

这种方式通过监听

AppDomain.CurrentDomain.UnhandledException

登录后复制

事件来实现。

using System;
using System.Windows.Forms; // 或者 using System.Windows; 对于WPF

namespace GlobalExceptionHandlerExample
{
    static class Program
    {
        [STAThread]
        static void Main()
        {
            // 订阅未处理异常事件
            AppDomain.CurrentDomain.UnhandledException += CurrentDomain_UnhandledException;

            Application.EnableVisualStyles();
            Application.SetCompatibleTextRenderingDefault(false);
            Application.Run(new Form1()); // 你的主窗体
        }

        private static void CurrentDomain_UnhandledException(object sender, UnhandledExceptionEventArgs e)
        {
            // 处理未处理的异常
            Exception ex = (Exception)e.ExceptionObject;

            // 记录日志
            Console.WriteLine("全局异常处理： " + ex.Message);
            // 或者使用更专业的日志库，如NLog, Serilog

            // 显示错误信息给用户 (可选)
            MessageBox.Show("程序出现未预料的错误，请查看日志文件。", "错误", MessageBoxButtons.OK, MessageBoxIcon.Error);

            // 决定是否终止程序
            // e.IsTerminating = true; // 默认是false，如果设置为true，程序会立即终止
        }
    }
}

登录后复制

重点：

在
```
Main
```
登录后复制
函数中订阅
```
AppDomain.CurrentDomain.UnhandledException
```
登录后复制
事件。
```
CurrentDomain_UnhandledException
```
登录后复制
方法是你的异常处理逻辑。
```
e.ExceptionObject
```
登录后复制
包含了异常的详细信息。
```
e.IsTerminating
```
登录后复制
决定了程序是否应该终止。通常情况下，不建议直接终止程序，除非你确定程序已经无法恢复。

2. TaskScheduler级别的异常处理 (异步操作)

对于异步操作，未处理的异常可能不会直接触发

AppDomain.CurrentDomain.UnhandledException

登录后复制

。这时，你需要使用

TaskScheduler.UnobservedTaskException

登录后复制

事件。

智谱清言 - 免费全能的AI助手

查看详情

using System;
using System.Threading.Tasks;

public class Example
{
    public static void Main()
    {
        // 订阅未观察到的Task异常事件
        TaskScheduler.UnobservedTaskException += TaskScheduler_UnobservedTaskException;

        // 启动一个Task，故意抛出一个异常
        Task.Run(() => { throw new Exception("Task中发生的异常！"); });

        // 强制垃圾回收，触发UnobservedTaskException事件
        GC.Collect();
        GC.WaitForPendingFinalizers();

        Console.ReadKey();
    }

    private static void TaskScheduler_UnobservedTaskException(object sender, UnobservedTaskExceptionEventArgs e)
    {
        // 处理未观察到的Task异常
        Exception ex = e.Exception.InnerException; // 获取实际的异常

        Console.WriteLine("Task异常处理: " + ex.Message);

        // 标记异常已被处理，防止程序崩溃
        e.SetObserved();
    }
}

登录后复制

重点：

```
TaskScheduler.UnobservedTaskException
```
登录后复制
事件在Task的异常未被观察到（例如，未被
```
await
```
登录后复制
或
```
.Result
```
登录后复制
访问）且Task被垃圾回收时触发。
```
e.Exception.InnerException
```
登录后复制
包含了实际的异常。
必须调用
```
e.SetObserved()
```
登录后复制
来标记异常已被处理，否则程序仍然可能崩溃。

全局异常处理会影响性能吗？

全局异常处理本身不会显著影响性能，因为它只有在发生未处理的异常时才会被触发。但是，如果在异常处理程序中执行大量的日志记录、资源清理或其他耗时操作，可能会对性能产生一定的影响。因此，建议在全局异常处理程序中尽量减少不必要的计算和I/O操作。

如何在ASP.NET Core中实现全局异常处理？

ASP.NET Core 提供了多种处理异常的方式，包括：

Exception Filter: 你可以创建一个全局异常过滤器来捕获和处理未处理的异常。
Middleware: 你可以创建一个自定义的中间件来捕获和处理异常。
UseExceptionHandler: ASP.NET Core 内置的中间件，可以用来处理异常并显示友好的错误页面。

使用Exception Filter的示例：

using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.Filters;
using Microsoft.Extensions.Logging;

public class GlobalExceptionFilter : IExceptionFilter
{
    private readonly ILogger<GlobalExceptionFilter> _logger;

    public GlobalExceptionFilter(ILogger<GlobalExceptionFilter> logger)
    {
        _logger = logger;
    }

    public void OnException(ExceptionContext context)
    {
        _logger.LogError(context.Exception, "发生全局异常");

        // 可以根据异常类型返回不同的结果
        if (context.Exception is ArgumentNullException)
        {
            context.Result = new BadRequestObjectResult("参数错误");
        }
        else
        {
            context.Result = new StatusCodeResult(500);
        }

        context.ExceptionHandled = true; // 标记异常已被处理
    }
}

登录后复制

需要在

Startup.cs

登录后复制

中注册该Filter:

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllers(options =>
    {
        options.Filters.Add(typeof(GlobalExceptionFilter));
    });
}

登录后复制