.NET MAUI iOS全局异常捕获：实现Flutter式错误页面方案求助

MAUI iOS的异常处理机制和Android/Windows存在差异，因为iOS对原生层异常的管控更严格，但可以通过结合托管层与原生层的双重捕获实现接近Flutter的全局异常处理效果，以下是可行方案：

1. 托管层（Managed）异常捕获 #

在App.xaml.cs中注册全局托管异常事件，覆盖UI线程、后台线程及Task未观察异常：

public partial class App : Application
{
    public App()
    {
        InitializeComponent();
        RegisterGlobalExceptionHandlers();
    }

    private void RegisterGlobalExceptionHandlers()
    {
        // 捕获非UI线程的未处理托管异常
        AppDomain.CurrentDomain.UnhandledException += (s, e) =>
        {
            if (e.ExceptionObject is Exception ex)
                ShowErrorPage(ex);
        };

        // 捕获Task未观察到的异常
        TaskScheduler.UnobservedTaskException += (s, e) =>
        {
            var targetEx = e.Exception.InnerException ?? e.Exception;
            ShowErrorPage(targetEx);
            e.SetObserved();
        };

        // 捕获UI线程的未处理异常
        this.Dispatcher.UnhandledException += (s, e) =>
        {
            ShowErrorPage(e.Exception);
            e.Handled = true;
        };
    }

    public void ShowErrorPage(Exception ex)
    {
        // 替换为自定义错误页，默认隐藏堆栈，仅展示友好提示
        MainPage = new ContentPage
        {
            Content = new VerticalStackLayout
            {
                Children =
                {
                    new Label { Text = "应用出现异常", FontSize = 24, Margin = new Thickness(0, 20) },
                    new Label { Text = "请稍后重试或重启应用", FontSize = 16 }
                    // 若需调试可添加：new Label { Text = ex.ToString(), IsVisible = false }
                },
                HorizontalOptions = LayoutOptions.Center,
                VerticalOptions = LayoutOptions.Center
            }
        };
    }
}

2. iOS原生层异常捕获 #

在Platforms/iOS/AppDelegate.cs中处理托管到原生的异常转换，以及Objective-C原生异常：

[Register("AppDelegate")]
public class AppDelegate : MauiUIApplicationDelegate
{
    protected override MauiApp CreateMauiApp() => MauiProgram.CreateMauiApp();

    public override bool FinishedLaunching(UIApplication application, NSDictionary launchOptions)
    {
        // 处理托管异常到原生层的转换
        ObjCRuntime.Runtime.MarshalManagedException += (s, e) =>
        {
            if (e.Exception is Exception ex)
            {
                // 切回MAUI UI线程展示错误页
                MainThread.BeginInvokeOnMainThread(() =>
                {
                    (Current.MainPage?.Parent as App)?.ShowErrorPage(ex);
                });
                // 标记异常已处理，避免iOS直接崩溃
                e.Handled = true;
            }
        };

        // 捕获Objective-C原生未捕获异常
        ObjCRuntime.NSSetUncaughtExceptionHandler((nativeEx) =>
        {
            var errorMsg = nativeEx?.Reason ?? "未知原生错误";
            MainThread.BeginInvokeOnMainThread(() =>
            {
                (Current.MainPage?.Parent as App)?.ShowErrorPage(new Exception(errorMsg));
            });
            // 注意：部分严重原生异常（如主线程死锁）仍可能导致崩溃，但此操作可优先展示错误页
        });

        return base.FinishedLaunching(application, launchOptions);
    }
}

关键注意事项 #

• 调试模式vs发布模式：调试时Visual Studio会中断所有异常，需切换到发布模式测试实际捕获效果。
• 原生异常限制：iOS对部分致命原生异常（如UIKit主线程非法操作）无法完全阻止崩溃，但上述方案可在崩溃前展示错误页，提升用户体验。
• 错误页可靠性：错误页需使用最简MAUI控件实现，避免因错误页自身引发二次异常。

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