AppDomain.CurrentDomain.UnhandledException是.NET框架中用于捕获应用程序域内未处理异常的关键事件，当程序中任何线程抛出未被捕获的异常时，该事件都会被触发，是全局异常处理的核心实现方式之一。
AppDomain.CurrentDomain.UnhandledException的作用
这个事件的核心作用是兜底捕获所有未被处理的异常，避免异常直接导致程序崩溃。正常情况下，我们会在代码中用try-catch块捕获预期的异常，但总会有遗漏的场景，比如第三方库抛出的未处理异常、异步方法中未捕获的异常等，这些异常如果没有被处理，就会触发AppDomain.CurrentDomain.UnhandledException事件。
事件触发后，我们可以执行以下操作：
- 记录异常详细信息到日志文件，方便后续排查问题
- 向用户展示友好的错误提示，而不是直接弹出系统错误框
- 执行必要的资源清理操作，避免资源泄漏
- 根据异常类型决定是否终止程序运行
基本使用方式
我们需要在应用程序启动的早期阶段订阅这个事件，确保所有可能的异常都能被捕获。以下是一个Windows Forms应用程序中的使用示例：
using System;
using System.Windows.Forms;
namespace GlobalExceptionDemo
{
static class Program
{
/// <summary>
/// 应用程序的主入口点
/// </summary>
[STAThread]
static void Main()
{
// 订阅全局未处理异常事件
AppDomain.CurrentDomain.UnhandledException += CurrentDomain_UnhandledException;
Application.EnableVisualStyles();
Application.SetCompatibleTextRenderingDefault(false);
Application.Run(new Form1());
}
/// <summary>
/// 全局未处理异常的处理逻辑
/// </summary>
private static void CurrentDomain_UnhandledException(object sender, UnhandledExceptionEventArgs e)
{
Exception ex = e.ExceptionObject as Exception;
string errorMsg = "发生未处理的异常：";
if (ex != null)
{
errorMsg += ex.Message + Environment.NewLine + ex.StackTrace;
}
else
{
errorMsg += e.ExceptionObject.ToString();
}
// 记录日志，这里简单输出到文件，实际项目可替换为日志组件
System.IO.File.AppendAllText("error.log", DateTime.Now.ToString() + " " + errorMsg + Environment.NewLine);
// 提示用户
MessageBox.Show("程序发生未知错误，请联系管理员", "错误提示", MessageBoxButtons.OK, MessageBoxIcon.Error);
// 如果异常是致命的，终止程序
if (e.IsTerminating)
{
Environment.Exit(1);
}
}
}
}
参数说明
事件的处理方法接收两个参数，分别是sender和UnhandledExceptionEventArgs类型的e，e包含两个重要属性：
| 属性名 | 说明 |
|---|---|
| ExceptionObject | 获取未处理的异常对象，需要转换为Exception类型才能获取详细信息 |
| IsTerminating | 获取一个值，表示公共语言运行时是否即将终止，大部分情况下该值为true |
使用注意事项
1. 事件订阅时机
必须在应用程序启动的最早阶段订阅事件，比如在Main方法的第一行就订阅，否则在订阅之前发生的未处理异常无法被捕获。
2. 无法恢复程序运行
大多数情况下，触发这个事件的异常都是致命的，公共语言运行时会终止应用程序，我们无法在事件处理方法中恢复程序的正常运行，只能执行清理和记录操作。
3. 多线程场景
该事件可以捕获所有线程中的未处理异常，包括工作线程、线程池线程抛出的异常，不需要额外为每个线程单独设置异常处理。
4. 与UI线程异常的区别
在Windows Forms或WPF程序中，UI线程的未处理异常会先触发Application.ThreadException（Windows Forms）或Dispatcher.UnhandledException（WPF）事件，这些事件可以阻止程序终止，而AppDomain.CurrentDomain.UnhandledException是最后一道防线，会捕获所有未被前面事件处理的异常。
结合UI线程异常处理的完整方案
为了实现更完善的全局异常处理，我们可以同时处理UI线程异常和应用程序域的未处理异常，以下是一个Windows Forms的完整示例：
using System;
using System.Threading;
using System.Windows.Forms;
namespace CompleteGlobalExceptionDemo
{
static class Program
{
[STAThread]
static void Main()
{
// 处理UI线程未处理异常
Application.ThreadException += Application_ThreadException;
// 处理应用程序域未处理异常
AppDomain.CurrentDomain.UnhandledException += CurrentDomain_UnhandledException;
// 设置捕获线程异常，避免线程异常未被捕获时直接崩溃
Application.SetUnhandledExceptionMode(UnhandledExceptionMode.CatchException);
Application.EnableVisualStyles();
Application.SetCompatibleTextRenderingDefault(false);
Application.Run(new Form1());
}
// UI线程未处理异常处理
private static void Application_ThreadException(object sender, ThreadExceptionEventArgs e)
{
HandleException(e.Exception, "UI线程未处理异常");
}
// 应用程序域未处理异常处理
private static void CurrentDomain_UnhandledException(object sender, UnhandledExceptionEventArgs e)
{
Exception ex = e.ExceptionObject as Exception;
HandleException(ex, "应用程序域未处理异常");
}
// 统一异常处理方法
private static void HandleException(Exception ex, string source)
{
string errorMsg = $"[{source}] {DateTime.Now:yyyy-MM-dd HH:mm:ss}" + Environment.NewLine;
if (ex != null)
{
errorMsg += $"错误信息：{ex.Message}" + Environment.NewLine;
errorMsg += $"堆栈跟踪：{ex.StackTrace}" + Environment.NewLine;
}
else
{
errorMsg += $"异常对象：{ex}" + Environment.NewLine;
}
// 写入日志
System.IO.File.AppendAllText("global_error.log", errorMsg + Environment.NewLine);
// 提示用户
MessageBox.Show($"程序发生错误：{ex?.Message ?? "未知错误"}，错误已记录，请联系管理员", "错误提示", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
}
}
总结
AppDomain.CurrentDomain.UnhandledException是.NET应用程序全局异常处理的重要组成部分，能够兜底捕获所有未被处理的异常，避免程序直接崩溃，同时帮助我们记录异常信息，提升应用程序的稳定性。在实际开发中，建议将其与UI线程异常处理结合使用，构建完整的异常处理体系，同时注意事件的订阅时机和异常处理的边界，不要试图在这个事件中恢复程序的正常运行。
AppDomainUnhandledException全局异常处理CSharp修改时间：2026-06-13 18:09:29