如何在WPF、WinForms与类库混合的C#应用中全局捕获未处理异常

你的场景很典型——混合技术栈的应用里，单一的DispatcherUnhandledException只能覆盖WPF UI线程的异常，类库后台线程、WinForms模块的异常根本抓不到。我来给你梳理下各个场景的捕获方案，确保所有未处理异常都能被记录：

1. 补全全局异常捕获的核心事件 #

在你的Application_Startup方法里，除了WPF的Dispatcher事件，还要订阅另外三个关键事件，覆盖不同场景：

private void Application_Startup(object sender, StartupEventArgs e)
{
    // WPF UI线程未处理异常（你已有的）
    Application.Current.DispatcherUnhandledException += AppDispatcherUnhandledException;
    
    // 应用域内所有后台线程/类库线程的未处理异常
    AppDomain.CurrentDomain.UnhandledException += CurrentDomain_UnhandledException;
    
    // 类库中异步方法未被await导致的"未观察Task异常"
    TaskScheduler.UnobservedTaskException += TaskScheduler_UnobservedTaskException;
    
    // WinForms UI线程的未处理异常
    System.Windows.Forms.Application.ThreadException += WinFormsThreadException;
}

然后实现对应的处理方法：

// 处理WinForms UI线程异常
private void WinFormsThreadException(object sender, System.Threading.ThreadExceptionEventArgs e)
{
    LogHelper.LogEntry(LogEntryModel.Create(this).Fatal($"WinForms异常：{e.Exception.StackTrace}"));
    e.ExceptionHandled = true; // 标记为已处理，避免系统弹出默认错误框
}

// 处理应用域内所有未被捕获的异常（包括类库后台线程）
private void CurrentDomain_UnhandledException(object sender, UnhandledExceptionEventArgs e)
{
    if (e.ExceptionObject is Exception ex)
    {
        LogHelper.LogEntry(LogEntryModel.Create(this).Fatal($"应用域未处理异常：{ex.StackTrace}"));
    }
    // 注意：这个事件触发后，.NET Framework默认会终止应用，除非配置了<legacyUnhandledExceptionPolicy>
    // 所以重点是做好日志记录，尽量让应用优雅退出
}

// 处理未被观察的Task异常（类库异步代码未await时触发）
private void TaskScheduler_UnobservedTaskException(object sender, UnobservedTaskExceptionEventArgs e)
{
    e.SetObserved(); // 标记为已观察，避免应用被CLR终止
    foreach (var ex in e.Exception.InnerExceptions)
    {
        LogHelper.LogEntry(LogEntryModel.Create(this).Fatal($"未观察Task异常：{ex.StackTrace}"));
    }
}

2. 针对类库服务的额外防护 #

既然日志指向类库的服务类，还要注意两个细节：

• 如果类库的服务方法是同步执行在后台线程，异常会走AppDomain.CurrentDomain.UnhandledException；
• 如果是异步方法但没被正确await，会触发TaskScheduler.UnobservedTaskException；
• 建议在类库的核心服务方法外层加一层全局try-catch，提前拦截异常并记录，避免扩散到应用层：

  public class CoreService
  {
      public void ExecuteCriticalOperation()
      {
          try
          {
              // 核心业务逻辑
          }
          catch (Exception ex)
          {
              LogHelper.LogEntry(LogEntryModel.Create(this).Fatal($"服务执行异常：{ex.StackTrace}"));
              // 根据业务需求，决定是否重新抛出（让上层处理）还是静默处理
              throw;
          }
      }
  }
  

3. 调试时的注意事项 #

调试模式下，Visual Studio会主动拦截所有异常，导致你的全局处理代码可能不生效。可以：

• 切换到Release模式测试；
• 或者在VS的「调试」→「Windows」→「异常设置」里，取消勾选「Common Language Runtime Exceptions」的抛出中断，这样全局处理逻辑会正常执行。

为什么你的原有代码没捕获到？ #

你之前只订阅了DispatcherUnhandledException，它只能捕获WPF UI线程上抛出的未处理异常。类库服务如果是在后台线程（比如用Task.Run、Thread启动）执行，异常根本不会进入WPF的Dispatcher管道，所以必须靠AppDomain和TaskScheduler的事件来捕获。

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