0

0

C#怎么捕获全局异常 C# AppDomain.CurrentDomain.UnhandledException处理方法

星降

星降

发布时间:2026-01-15 10:15:09

|

200人浏览过

|

来源于php中文网

原创

C#全局异常捕获需组合使用AppDomain.UnhandledException(非UI线程)、Application.ThreadException(WinForms UI线程)、DispatcherUnhandledException(WPF UI线程)和TaskScheduler.UnobservedTaskException(异步任务),缺一不可。

c#怎么捕获全局异常 c# appdomain.currentdomain.unhandledexception处理方法

在 C# 中捕获全局未处理异常,主要靠 AppDomain.CurrentDomain.UnhandledException 事件,但它**只适用于非 UI 线程和主线程中未被 try-catch 捕获的异常**,且**无法阻止程序退出**(仅能记录日志、做善后)。它不是“万能兜底”,尤其对 WinForms/WPF 的 UI 线程异常需配合其他机制。

AppDomain.UnhandledException 基本用法

该事件在异常未被任何 catch 捕获、即将导致进程终止前触发。注册一次即可,通常放在 Main() 开头或应用启动处:

示例:

static void Main(string[] args)
{
    AppDomain.CurrentDomain.UnhandledException += (sender, e) =>
    {
        var ex = e.ExceptionObject as Exception;
        Console.WriteLine($"全局异常:{ex?.Message}");
        // 记录日志、保存状态、弹提示(谨慎)、发送告警等
        // ⚠️ 注意:e.IsTerminating 为 true,此时不应调用复杂逻辑或 UI 操作
    };
// 启动你的主逻辑
Application.Run(new MainForm()); // WinForms 示例

}

它不能捕获哪些异常?

以下情况 不会触发 此事件:

  • UI 线程中抛出的异常(如 WinForms 的 Button.Click 内未捕获异常)——这类由 Windows 消息循环拦截,需用 Application.ThreadException(WinForms)或 DispatcherUnhandledException(WPF)
  • Task 异常未 await 或未 .Wait()/.Result —— 默认不传播到主线程,需监听 TaskScheduler.UnobservedTaskException
  • 已用 try-catch 捕获并吞掉的异常
  • StackOverflowException、OutOfMemoryException(部分情况下)等严重运行时异常

WinForms / WPF 必须补充的监听

为了真正“全局”,必须组合使用:

Convai Technologies Inc.
Convai Technologies Inc.

对话式 AI API,用于设计游戏和支持端到端的语音交互

下载
  • WinForms:注册 Application.ThreadException 处理 UI 线程异常
  • WPF:在 App.xaml.cs 中订阅 Application.DispatcherUnhandledException
  • 所有托管线程:加上 TaskScheduler.UnobservedTaskException 防止遗漏异步异常

WinForms 完整示例片段:

static void Main()
{
    // 1. UI 线程异常(关键!)
    Application.ThreadException += (s, e) =>
    {
        LogError("UI线程异常", e.Exception);
        MessageBox.Show("发生错误,请重启应用。");
    };
// 2. 其他线程 + 主线程非 UI 异常
AppDomain.CurrentDomain.UnhandledException += (s, e) =>
{
    LogError("未处理异常", e.ExceptionObject as Exception);
};

// 3. 异步任务异常(未观察到的)
TaskScheduler.UnobservedTaskException += (s, e) =>
{
    e.SetObserved(); // 标记为已处理,避免后续终止
    LogError("未观察到的任务异常", e.Exception);
};

Application.EnableVisualStyles();
Application.SetCompatibleTextRenderingDefault(false);
Application.Run(new MainForm());

}

注意事项与最佳实践

这些事件是“最后机会”,但有严格限制:

  • 不要在其中执行耗时操作(如写大文件、网络请求)——进程可能随时终止
  • 避免调用 UI 控件(如 MessageBox 在非 UI 线程弹窗会失败),如需提示,用 BeginInvoke 或检查线程上下文
  • 记录日志建议用轻量方式(如写入本地文本、EventLog),并确保路径可写
  • e.IsTerminating 为 true 时,禁止 throw 新异常或调用 Environment.Exit()
  • .NET Core/.NET 5+ 中 AppDomain 已弱化,推荐优先用 HostBuilderUseExceptionHandler(ASP.NET)或 Try-Catch in Main + 全局日志中间件

基本上就这些。AppDomain.UnhandledException 是重要一环,但不是全部——搭配 ThreadException、DispatcherUnhandledException 和 TaskScheduler 三者,才能覆盖绝大多数托管异常场景。

相关专题

更多
什么是中间件
什么是中间件

中间件是一种软件组件,充当不兼容组件之间的桥梁,提供额外服务,例如集成异构系统、提供常用服务、提高应用程序性能,以及简化应用程序开发。想了解更多中间件的相关内容,可以阅读本专题下面的文章。

177

2024.05.11

Golang 中间件开发与微服务架构
Golang 中间件开发与微服务架构

本专题系统讲解 Golang 在微服务架构中的中间件开发,包括日志处理、限流与熔断、认证与授权、服务监控、API 网关设计等常见中间件功能的实现。通过实战项目,帮助开发者理解如何使用 Go 编写高效、可扩展的中间件组件,并在微服务环境中进行灵活部署与管理。

212

2025.12.18

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

480

2023.08.10

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

480

2023.08.10

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

576

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1099

2023.07.27

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

790

2023.08.01

windows查看端口被占用的情况
windows查看端口被占用的情况

windows查看端口被占用的情况的方法:1、使用Windows自带的资源监视器;2、使用命令提示符查看端口信息;3、使用任务管理器查看占用端口的进程。本专题为大家提供windows查看端口被占用的情况的相关的文章、下载、课程内容,供大家免费下载体验。

452

2023.08.02

Golang gRPC 服务开发与Protobuf实战
Golang gRPC 服务开发与Protobuf实战

本专题系统讲解 Golang 在 gRPC 服务开发中的完整实践,涵盖 Protobuf 定义与代码生成、gRPC 服务端与客户端实现、流式 RPC(Unary/Server/Client/Bidirectional)、错误处理、拦截器、中间件以及与 HTTP/REST 的对接方案。通过实际案例,帮助学习者掌握 使用 Go 构建高性能、强类型、可扩展的 RPC 服务体系,适用于微服务与内部系统通信场景。

8

2026.01.15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 7.2万人学习

Excel 教程
Excel 教程

共162课时 | 11.8万人学习

PHP基础入门课程
PHP基础入门课程

共33课时 | 1.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号