WPF应用未处理异常捕获问题：AppDomain事件无法捕获异常

我来帮你搞定这个WPF异常捕获的问题——你说AppDomain.CurrentDomain.UnhandledException抓不到异常，大概率是没踩对WPF异常处理的优先级和注册时机的坑，咱们一步步来梳理解决：

先明确两个事件的分工 #

首先得搞清楚这两个事件的触发逻辑：

• Application.Current.DispatcherUnhandledException：专门负责捕获UI线程上未处理的异常，是WPF层面的异常拦截器，优先级比AppDomain的事件高。
• AppDomain.CurrentDomain.UnhandledException：是全局层面的兜底，负责捕获所有**非UI线程（比如后台线程）**的未处理异常，以及UI线程异常中没被标记为“已处理”的部分。

常见的“抓不到”原因及解决办法 #

1. 事件注册时机太晚 #

这是最容易踩的坑！如果你的AppDomain.UnhandledException是在主窗口初始化后才注册的，那应用启动过程中或者早期的后台线程异常就会漏掉。

正确做法：在应用启动的最早期注册，比如在App类的构造函数里：

public App()
{
    // 先注册全局兜底事件，再注册UI线程事件
    AppDomain.CurrentDomain.UnhandledException += CurrentDomain_UnhandledException;
    Application.Current.DispatcherUnhandledException += DispatcherUnhandledException;
}

2. 错误设置了DispatcherUnhandledException的e.Handled = true #

如果你在UI线程异常处理中把e.Handled设为true，WPF就会认为这个异常已经被处理完毕，不会再把它传递给AppDomain的事件。

如果你希望UI异常也能触发全局兜底：就不要设置e.Handled = true；如果只是想阻止程序崩溃但不需要全局处理，那保持e.Handled = true即可。

3. 后台线程用了Task而非Thread #

在.NET 4.5及以后，Task的未处理异常不会直接触发AppDomain.UnhandledException，而是会被TaskScheduler.UnobservedTaskException事件捕获。如果你的后台逻辑用了Task.Run或者异步方法未等待，就得额外注册这个事件：

public App()
{
    // 加上Task异常的处理
    TaskScheduler.UnobservedTaskException += TaskScheduler_UnobservedTaskException;
    // 其他事件注册...
}

private void TaskScheduler_UnobservedTaskException(object sender, UnobservedTaskExceptionEventArgs e)
{
    // 处理未被观察到的Task异常
    MessageBox.Show($"后台任务错误：{e.Exception.InnerException?.Message ?? e.Exception.Message}", "提示");
    e.SetObserved(); // 标记为已处理，避免应用因未观察到的Task异常终止
}

完整代码示例 #

这里给你一个覆盖所有场景的App.xaml.cs示例：

using System;
using System.Threading.Tasks;
using System.Windows;
using System.Windows.Threading;

namespace YourWpfApp
{
    public partial class App : Application
    {
        public App()
        {
            // 按优先级注册事件：全局兜底 -> Task异常 -> UI线程异常
            AppDomain.CurrentDomain.UnhandledException += CurrentDomain_UnhandledException;
            TaskScheduler.UnobservedTaskException += TaskScheduler_UnobservedTaskException;
            Application.Current.DispatcherUnhandledException += DispatcherUnhandledException;
        }

        private void DispatcherUnhandledException(object sender, DispatcherUnhandledExceptionEventArgs e)
        {
            // 处理UI线程异常
            MessageBox.Show($"UI线程错误：{e.Exception.Message}", "提示");
            // 如果你想让这个异常继续触发AppDomain事件，就注释掉下面这行
            // e.Handled = true;
        }

        private void CurrentDomain_UnhandledException(object sender, UnhandledExceptionEventArgs e)
        {
            // 全局兜底处理，所有未被拦截的异常都会到这里
            var exception = e.ExceptionObject as Exception;
            MessageBox.Show($"严重错误：{exception?.Message ?? "未知异常"}，应用即将关闭", "警告");
            // 注意：这个事件触发后，应用通常会终止，除非配置了legacyUnhandledExceptionPolicy
        }

        private void TaskScheduler_UnobservedTaskException(object sender, UnobservedTaskExceptionEventArgs e)
        {
            // 处理Task中未被等待的异常
            MessageBox.Show($"后台任务错误：{e.Exception.InnerException?.Message ?? e.Exception.Message}", "提示");
            e.SetObserved(); // 标记为已处理，防止应用终止
        }

        protected override void OnStartup(StartupEventArgs e)
        {
            base.OnStartup(e);
            MainWindow = new MainWindow();
            MainWindow.Show();
        }
    }
}

额外配置注意 #

如果你的应用需要更严格的异常处理行为，可以在App.config中添加legacyUnhandledExceptionPolicy配置：

<configuration>
    <runtime>
        <!-- enabled="1" 回到.NET 2.0行为，AppDomain事件触发后立即终止应用 -->
        <!-- enabled="0" 是默认值，允许执行一些清理操作后再终止 -->
        <legacyUnhandledExceptionPolicy enabled="0"/>
    </runtime>
</configuration>

内容的提问来源于stack exchange，提问作者MyNewName