.NET MAUI iOS真机多次导航时随机崩溃问题求助

问题描述 #

使用基于栈的导航（类似Xamarin.Forms的主详情导航），Android和iOS模拟器运行正常，但iPhone真机上会随机崩溃：

• iPhone 13：执行await Detail.Navigation.PushAsync(new ApplicationSetting(), true);约3次后崩溃
• iPhone 13 Pro Max：首次部署正常，再次部署后导航5-7次崩溃，崩溃无固定规律
• 仅少数测试中出现System.InvalidCastException异常
• 已尝试调试/发布模式、导航前清空栈，问题未解决

相关代码 #

App.xaml.cs #

MainPage = new Sidebar()
{
      FlowDirection = FlowDirection.LeftToRight
};

Sidebar.xaml.cs #

public partial class Sidebar : FlyoutPage
{
    public Sidebar()
    {
        InitializeComponent();
        Detail = new NavigationPage(new MainPage());
    }

 private async void GoToApplicationSettingsPage(object sender, TappedEventArgs e)
 {
     await Detail.Navigation.PushAsync(new ApplicationSetting());
     IsPresented = false;
 }

 private async void GoToHxSettingsPage(object sender, TappedEventArgs e)
 {
     await Detail.Navigation.PushAsync(new MedicalHistorySettings(), true);
     IsPresented = false;
 }

 private async void GoToVisitsSettingsPage(object sender, TappedEventArgs e)
 {
     await Detail.Navigation.PushAsync(new VisitsSettings(), true);
     IsPresented = false;
 }

 private async void GoToOperationsSettingsPage(object sender, TappedEventArgs e)
 {
     await Detail.Navigation.PushAsync(new OperationsSettings(), true);
     IsPresented = false;
 }

 private async void GoToVisitsSerachPage(object sender, TappedEventArgs e)
 {
     await Detail.Navigation.PushAsync(new VisitsSearch(), true);
     IsPresented = false;
 }

 private async void GoToOperationsSearchPage(object sender, TappedEventArgs e)
 {
     await Detail.Navigation.PushAsync(new OperationsSearch(), true);
     IsPresented = false;
 }
}

解决方案 #

1. 修正异步事件处理器的线程问题 #

iOS真机对UI线程同步要求严格，async void事件处理器容易导致线程上下文混乱。统一封装导航逻辑，确保操作在UI线程执行：

private async Task NavigateToPage(Page targetPage, bool animated = true)
{
    if (MainThread.IsMainThread)
    {
        await Detail.Navigation.PushAsync(targetPage, animated);
        IsPresented = false;
    }
    else
    {
        await MainThread.InvokeOnMainThreadAsync(async () =>
        {
            await Detail.Navigation.PushAsync(targetPage, animated);
            IsPresented = false;
        });
    }
}

// 调用示例
private async void GoToApplicationSettingsPage(object sender, TappedEventArgs e)
{
    await NavigateToPage(new ApplicationSetting());
}

2. 固定NavigationPage实例 #

避免重复创建或意外释放导航栈实例，在Sidebar中维护唯一的NavigationPage引用：

private NavigationPage _mainNavigation;

public Sidebar()
{
    InitializeComponent();
    _mainNavigation = new NavigationPage(new MainPage());
    Detail = _mainNavigation;
}

// 后续导航统一使用该实例
await _mainNavigation.Navigation.PushAsync(targetPage, animated);

3. 清理页面生命周期资源 #

iOS真机崩溃常与资源泄漏有关，检查所有目标页面的OnDisappearing方法，确保释放资源、取消事件订阅：

protected override void OnDisappearing()
{
    // 取消事件订阅
    someControl.Tapped -= SomeEventHandler;
    // 释放非托管资源
    disposableResource?.Dispose();
    base.OnDisappearing();
}

4. 捕获全局异常定位问题 #

添加全局异常捕获，收集详细崩溃日志：

protected override void OnStart()
{
    AppDomain.CurrentDomain.UnhandledException += CurrentDomain_UnhandledException;
    TaskScheduler.UnobservedTaskException += TaskScheduler_UnobservedTaskException;
}

private void CurrentDomain_UnhandledException(object sender, UnhandledExceptionEventArgs e)
{
    File.WriteAllText(Path.Combine(FileSystem.AppDataDirectory, "crash.log"), e.ExceptionObject.ToString());
}

private void TaskScheduler_UnobservedTaskException(object sender, UnobservedTaskExceptionEventArgs e)
{
    File.WriteAllText(Path.Combine(FileSystem.AppDataDirectory, "task_crash.log"), e.Exception.ToString());
    e.SetObserved();
}

5. 更新MAUI SDK到最新稳定版 #

部分iOS导航崩溃属于SDK已知bug，执行dotnet workload update maui更新到最新版本，修复底层问题。

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