MAUI中FlyoutItem导航异常：点击最后一项后视图不切换且导航失效

以下是针对该问题的几个实用排查和解决方向：

• 检查SongListPage构造函数是否有阻塞操作
  第三个页面初始化时如果存在同步耗时操作（比如大量数据同步读取）或未捕获异常，会卡住UI线程，表现为导航“假死”。建议将初始化逻辑移到异步方法中处理：

  protected override async void OnAppearing()
  {
      base.OnAppearing();
      await LoadSongDataAsync(); // 异步加载数据，避免阻塞UI
  }
  

  同时添加全局异常捕获，排查是否有隐藏异常：

  public partial class App : Application
  {
      public App()
      {
          InitializeComponent();
          MainPage = new AppShell();
          AppDomain.CurrentDomain.UnhandledException += (s, e) => 
              Debug.WriteLine($"全局未捕获异常：{(e.ExceptionObject as Exception)?.Message}");
          TaskScheduler.UnobservedTaskException += (s, e) => 
              Debug.WriteLine($"任务未捕获异常：{e.Exception.Message}");
      }
  }
  

• 给FlyoutItem和ShellContent显式指定Route
  未设置路由可能导致Shell导航逻辑异常，尝试为每个导航项添加路由：

  <FlyoutItem Title="Home" Icon="house_white.png" Route="home">
      <ShellContent ContentTemplate="{DataTemplate local:MainPage}" Route="main" />
  </FlyoutItem>
  <FlyoutItem Title="Albums" Icon="plus_white.png" Route="albums">
      <ShellContent ContentTemplate="{DataTemplate views:AlbumListPage}" Route="albumlist" />
  </FlyoutItem>
  <FlyoutItem Title="Songs" Icon="upload_icon.png" Route="songs">
      <ShellContent ContentTemplate="{DataTemplate views:SongListPage}" Route="songlist" />
  </FlyoutItem>
  

• 简化SongListPage的XAML布局排查问题
  若页面XAML存在无效绑定、布局循环或未定义控件，会导致页面无法渲染，进而引发导航异常。先简化页面代码测试：

  <ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
               xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
               x:Class="test_project.Views.SongListPage"
               Title="Songs">
      <VerticalStackLayout>
          <Label Text="Songs Page" VerticalOptions="Center" HorizontalOptions="Center" />
      </VerticalStackLayout>
  </ContentPage>
  

  如果简化后能正常跳转，再逐步还原原布局，定位错误点。

• 清理项目缓存后重新生成
  MAUI项目缓存可能引发奇怪的导航问题，执行以下操作：

  • 删除项目根目录下的bin和obj文件夹
  • 在IDE中执行清理解决方案再重新生成解决方案
  • 卸载模拟器/设备上的应用，重新部署测试

内容的提问来源于stack exchange，提问作者Ilian Gion Häsler