AppDomain.CurrentDomain.UnhandledException仅捕获主线程及未捕获的后台线程异常,不处理UI线程(需ThreadException/DispatcherUnhandledException)、Task(需观察或UnobservedTaskException)及Web请求异常(需中间件)。

AppDomain.CurrentDomain.UnhandledException 能捕获哪些异常
它只抓得到主线程(或未被 try/catch 包裹的后台线程)里彻底没人处理的异常,比如 NullReferenceException、ArgumentException 这类运行时抛出又没被捕获的。UI 线程上 WPF/WinForms 的未处理异常默认会走这里,但 ASP.NET Core 或 .NET 6+ 的控制台程序里,它可能根本收不到——因为宿主层已经提前吞掉了。
常见错误现象:AppDomain.CurrentDomain.UnhandledException 注册了却完全不触发,尤其在 .NET 5+ 新项目中;或者只在调试器下触发,发布后静默退出。
- 必须在
Main方法最开头注册,晚了就来不及 - 不能靠它来“恢复程序”,事件里只能记录日志、保存状态,然后建议退出
- 它不阻断崩溃,
e.IsTerminating为true说明进程马上要挂了
Windows Forms 和 WPF 各自该监听什么事件
WinForms 要补上 Application.ThreadException,否则 UI 线程上的异常(比如按钮点击里崩了)会被系统弹窗拦截,根本到不了 AppDomain 那层;WPF 则得监听 Application.DispatcherUnhandledException,它专管 Dispatcher 线程(也就是 UI 线程)抛出的未处理异常。
使用场景:你改了一个按钮事件,测试时点一下直接弹 Windows 错误框,但日志里没记录——大概率是漏了这两个事件之一。
- WinForms:在
Program.Main里调用Application.SetUnhandledExceptionMode(UnhandledExceptionMode.CatchException),再加Application.ThreadException += ... - WPF:在
App.xaml.cs的OnStartup里加this.DispatcherUnhandledException += ... - 两者都需设置
e.Handled = true才能阻止系统默认弹窗,但别滥用——有些致命异常(如栈溢出)设了也拦不住
Task 里的异常为什么总捕获不到
Task.Run(() => { throw new Exception(); }) 不会触发任何全局异常处理器,除非你显式 .Wait() 或 .GetAwaiter().GetResult()。异步任务的异常被封在 Task 对象里,只有等到它被观察(observed)时才可能冒泡。没观察的异常会在 GC 时触发 TaskScheduler.UnobservedTaskException,但 .NET 4.5+ 默认已把未观察异常设为“不终止进程”,所以程序看似正常跑着,其实异常丢了。
性能影响:频繁触发 UnobservedTaskException 会影响 GC 效率,且容易掩盖逻辑缺陷。
- 首选方案:所有
await的地方确保外层有try/catch - 兜底方案:注册
TaskScheduler.UnobservedTaskException,并在事件里调用e.SetObserved()防止后续警告 - 别依赖
ContinueWith(task => ..., TaskContinuationOptions.OnlyOnFaulted)做统一错误处理——它不覆盖await场景,且容易漏掉取消状态
.NET 6+ 控制台和 Web API 的差异处理
控制台程序默认没有 UI 线程,ThreadException 和 DispatcherUnhandledException 全无效;Web API(如 ASP.NET Core)则由中间件接管异常,AppDomain 事件基本收不到请求上下文里的异常。这时候得靠 app.UseExceptionHandler(...) 或全局过滤器(ExceptionFilterAttribute)。
兼容性注意:.NET 5 开始 AppDomain 已被标记为“不推荐使用”,但在桌面应用里仍是事实标准;.NET 6+ 控制台若用了 Host.CreateDefaultBuilder,应优先用 IHostApplicationLifetime.ApplicationStopped 配合日志记录,而非强依赖 AppDomain。
- 控制台程序:注册
AppDomain.CurrentDomain.UnhandledException+ 检查是否启用了Environment.FailFast(某些 SDK 版本会默认开) - ASP.NET Core:禁用
DeveloperExceptionPage生产环境行为,用UseExceptionHandler返回结构化错误响应 - 跨平台服务(如 Linux 守护进程):记得捕获
SIGTERM信号做优雅退出,这和异常捕获无关,但常被一起忽略
真正难的不是注册几个事件,而是分清异常发生在线程、Task、Dispatcher、HTTP 请求哪个层面——同一段代码,在 WinForms 里要三处监听,在控制台里可能只有一处有效,在 Web API 里全得重写。漏掉任意一层,用户看到的就是一个没日志、没提示、突然消失的程序。










