MAUI应用未处理异常时DisplayAlert不显示问题求助

问题根源 #

1. 线程上下文不匹配：AppDomain.CurrentDomain.UnhandledException的回调运行在非UI线程，而DisplayAlert必须在UI线程环境下执行。
2. 应用终止时机冲突：当e.IsTerminating为true时，应用会在回调执行后立刻终止，弹窗还未完成渲染就被关闭。
3. 异步方法上下文丢失：使用async static void作为事件处理程序，会导致异步操作的UI上下文丢失，且异常无法被正确捕获。

修复方案 #

1. 切换到UI线程执行弹窗 #

通过MainThread.InvokeOnMainThreadAsync将弹窗操作调度到UI线程，并判断应用是否即将终止：

public static void OnUnhandledException(object sender, UnhandledExceptionEventArgs e)
{
    Exception exception = (Exception)e.ExceptionObject;
    bool isTerminating = e.IsTerminating;

    // 调度到UI线程执行弹窗逻辑
    _ = MainThread.InvokeOnMainThreadAsync(async () =>
    {
        // 仅当应用不终止时尝试显示弹窗
        if (!isTerminating && Shell.Current != null)
        {
            await Shell.Current.DisplayAlert("Error", "Something went wrong!", "OK");
        }
    });

    Console.WriteLine($"\nUnhandled Exception occurred: *{exception}*\nTERMINATING?:{isTerminating}");
}

2. 补充订阅MAUI异步任务异常事件 #

除了AppDomain的事件，还需处理异步任务中未捕获的异常，避免遗漏场景：
在MauiProgram.cs的CreateMauiApp方法中添加：

var app = builder.Build();

// 处理全局未处理异常
AppDomain.CurrentDomain.UnhandledException += OnUnhandledException;

// 处理异步任务未捕获异常
TaskScheduler.UnobservedTaskException += (s, args) =>
{
    args.SetObserved(); // 标记异常已处理，防止应用强制终止
    _ = MainThread.InvokeOnMainThreadAsync(async () =>
    {
        if (Shell.Current != null)
        {
            await Shell.Current.DisplayAlert("Async Error", "An async task failed!", "OK");
        }
    });
    Console.WriteLine($"Unobserved Task Exception: {args.Exception}");
};

return app;

3. 延迟订阅确保Shell初始化完成 #

如果异常发生在应用启动早期（如App构造阶段），Shell.Current可能为null，可在App.xaml.cs的OnStart方法中延迟订阅事件：

protected override void OnStart()
{
    base.OnStart();
    // 确保Shell实例已初始化后再订阅异常事件
    AppDomain.CurrentDomain.UnhandledException += MauiProgram.OnUnhandledException;
}

注意事项 #

• 当e.IsTerminating为true时，应用即将退出，此时弹窗基本无法正常显示，建议仅在非终止场景下触发弹窗。
• 异常处理逻辑应尽量简洁，避免执行耗时操作，防止应用挂起或延迟终止。

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