0

0

Avalonia怎么实现一个全局异常处理器 Avalonia捕获未处理异常

煙雲

煙雲

发布时间:2026-01-17 13:01:02

|

793人浏览过

|

来源于php中文网

原创

在 Avalonia 中实现全局异常处理需三者配合:1. 注册 AppDomain.CurrentDomain.UnhandledException 捕获主线程崩溃异常;2. 订阅 TaskScheduler.UnobservedTaskException 处理未观察的 Task 异常;3. 重写 Application.OnUnhandledException(Avalonia 11+)捕获 UI 线程框架内未处理异常,三者覆盖绝大多数场景。

avalonia怎么实现一个全局异常处理器 avalonia捕获未处理异常

在 Avalonia 中实现全局异常处理器,核心是捕获应用主线程未处理的异常(如 UI 线程中抛出但未被 try/catch 捕获的异常),以及任务异步操作中未观察到的异常。Avalonia 本身基于 .NET 运行时,因此需结合 .NET 的异常捕获机制,并在 Avalonia 生命周期关键节点进行注册。

监听 AppDomain.CurrentDomain.UnhandledException

这是捕获非托管线程或部分同步上下文中未处理异常的兜底方式,适用于大多数崩溃性异常(如 NullReferenceException 在事件处理中直接抛出)。

  • App.xaml.cs 的 App() 构造函数或 App.Initialize() 之前 就注册,确保尽早生效
  • 该事件无法阻止应用退出,但可用于日志记录、弹窗提示或数据保存
  • 注意:它不捕获 async void 方法中的异常,也不捕获 Task 异常(除非未 await 且未被 TaskScheduler.UnobservedTaskException 捕获)

订阅 TaskScheduler.UnobservedTaskException

用于捕获被丢弃(未 await、未 .Wait()、未 .Result)的 Task 中抛出的异常。这类异常默认会被静默吞掉,直到 GC 时触发此事件。

  • 建议在应用启动早期(如 App.OnFrameworkInitializationCompleted 或 Program.BuildAvaloniaApp().StartWithClassicDesktopLifetime() 之后)注册
  • 调用 e.SetObserved() 可标记为“已处理”,避免最终触发 AppDomain.UnhandledException
  • 典型场景:忘记 await 一个命令执行、后台 Task.Run 内部出错但没处理

重写 Application.OnUnhandledException(Avalonia 11+ 推荐)

Avalonia 11 起提供了更贴近框架语义的入口:Application.OnUnhandledException,它会在 Avalonia 内部检测到 UI 线程未处理异常(如路由事件处理器、绑定转换器、控件生命周期方法中抛异常)时被调用。

PaperAiBye
PaperAiBye

支持近30多种语言降ai降重,并且支持多种语言免费测句子的ai率,支持英文aigc报告等

下载
  • 继承自 Application 类,在其中重写该方法
  • OnUnhandledException 传入的 UnhandledExceptionEventArgs 包含 ExceptionHandled 属性
  • 设置 e.Handled = true 可阻止 Avalonia 默认的崩溃行为(如弹出错误对话框),自行处理(如显示友好提示、上报)
  • 注意:它不替代 AppDomain 或 TaskScheduler 的监听,而是补充 Avalonia 特定上下文

可选:包装 Dispatcher.UIThread.Post/Invoke 操作

对于手动调度到 UI 线程的代码(如 Dispatcher.UIThread.InvokeAsync(() => { ... })),异常不会自动冒泡到全局处理器。可封装一层安全调用:

  • 定义扩展方法如 SafeInvokeAsync(this IDispatcher dispatcher, Action action)
  • 内部用 try/catch 包裹并转发到全局日志或提示系统
  • 适合对关键 UI 更新逻辑做防御性增强,非必须但能提升健壮性

基本上就这些。三者配合使用(AppDomain + TaskScheduler + OnUnhandledException)可覆盖绝大多数未处理异常场景。不需要第三方库,纯 Avalonia + .NET 原生机制即可实现可靠捕获。

相关专题

更多
javascriptvoid(o)怎么解决
javascriptvoid(o)怎么解决

javascriptvoid(o)的解决办法:1、检查语法错误;2、确保正确的执行环境;3、检查其他代码的冲突;4、使用事件委托;5、使用其他绑定方式;6、检查外部资源等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

175

2023.11.23

java中void的含义
java中void的含义

本专题整合了Java中void的相关内容,阅读专题下面的文章了解更多详细内容。

97

2025.11.27

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

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

481

2023.08.10

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

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

481

2023.08.10

高德地图升级方法汇总
高德地图升级方法汇总

本专题整合了高德地图升级相关教程,阅读专题下面的文章了解更多详细内容。

2

2026.01.16

全民K歌得高分教程大全
全民K歌得高分教程大全

本专题整合了全民K歌得高分技巧汇总,阅读专题下面的文章了解更多详细内容。

0

2026.01.16

C++ 单元测试与代码质量保障
C++ 单元测试与代码质量保障

本专题系统讲解 C++ 在单元测试与代码质量保障方面的实战方法,包括测试驱动开发理念、Google Test/Google Mock 的使用、测试用例设计、边界条件验证、持续集成中的自动化测试流程,以及常见代码质量问题的发现与修复。通过工程化示例,帮助开发者建立 可测试、可维护、高质量的 C++ 项目体系。

10

2026.01.16

java数据库连接教程大全
java数据库连接教程大全

本专题整合了java数据库连接相关教程,阅读专题下面的文章了解更多详细内容。

33

2026.01.15

Java音频处理教程汇总
Java音频处理教程汇总

本专题整合了java音频处理教程大全,阅读专题下面的文章了解更多详细内容。

15

2026.01.15

热门下载

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

精品课程

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

共28课时 | 3.2万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.1万人学习

Sass 教程
Sass 教程

共14课时 | 0.8万人学习

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

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