MAUI Shell首个ShellContent无法导航及崩溃问题求助

问题1：首个ShellContent页面无法通过汉堡菜单再次导航 #

无论将哪个页面设置为Shell的首个ShellContent，应用启动时可正常加载该页面，但点击汉堡菜单再次选择该页面时无任何响应；调整ShellContent顺序后，首个条目始终存在此问题。

问题2：返回页面时抛出ArgumentOutOfRangeException崩溃 #

导航至其他页面后返回，应用直接崩溃，抛出异常：

System.ArgumentOutOfRangeException: Index was out of range. Must be non-negative and less than the size of the collection. (Parameter 'index')

崩溃触发点在Program.cs的UIApplication.Main入口处。目前发现隐藏菜单选项并使用无逻辑的干净页面时，错误不再出现，暂推测与DataContext未正确释放有关。

相关代码 #

AppShell.xaml

<?xml version="1.0" encoding="UTF-8" ?>
<Shell
    x:Class="Manager.AppShell"
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    xmlns:local="clr-namespace:Manager"
    xmlns:pages="clr-namespace:Manager.Pages"
    Shell.FlyoutBehavior="Flyout">

    <Shell.FlyoutHeaderTemplate>
    <DataTemplate>
        <Grid BackgroundColor="DimGray">
            <Label>Configuration</Label>
        </Grid>
    </DataTemplate>

    </Shell.FlyoutHeaderTemplate>

    <ShellContent
        Title="Manager"
        ContentTemplate="{DataTemplate local:MainPage}"
        Route="MainPage" />
    <ShellContent
        Title="add item"
        ContentTemplate="{DataTemplate pages:AddItemPage}"
        Route="pages:AddItemPage" />
    <ShellContent
        Title="check Items"
        ContentTemplate="{DataTemplate pages:CheckItemPage}"
    Route="pages:CheckItemPage" />
</Shell>

AppShell.xaml.cs

namespace Manager;

public partial class AppShell : Shell
{
    public AppShell()
    {
        InitializeComponent();
    }
}

环境说明 #

• 所有页面在MauiProgram.cs中注册为Transient生命周期
• 运行环境：iOS模拟器
• 此前功能正常，近期出现上述问题

排查建议 #

针对问题1

• 显式注册路由：在AppShell构造函数中添加路由注册代码，确保路由与页面匹配，示例：

  Routing.RegisterRoute(nameof(MainPage), typeof(MainPage));
  Routing.RegisterRoute(nameof(AddItemPage), typeof(AddItemPage));
  

• 用FlyoutItem包裹ShellContent：将所有ShellContent放入同一个FlyoutItem容器，或为每个ShellContent单独创建FlyoutItem，避免直接在Shell下嵌套ShellContent
• 检查页面生命周期方法：查看页面的OnAppearing/OnDisappearing是否存在阻塞逻辑，导致导航事件无法处理
• 开启导航日志：在MauiProgram.cs中添加日志配置，查看导航过程中的细节：

  builder.ConfigureLogging(logging => logging.AddDebug().SetMinimumLevel(LogLevel.Trace));
  

针对问题2

• 清理DataContext：在页面的OnDisappearing方法中手动清空BindingContext并取消事件订阅，示例：

  protected override void OnDisappearing()
  {
      base.OnDisappearing();
      BindingContext = null;
      // 取消所有已订阅的事件，避免内存泄漏
  }
  

• 调整页面生命周期：尝试将页面注册改为Scoped，观察是否仍会崩溃
• 捕获详细堆栈：在Visual Studio中开启异常捕获（勾选"Common Language Runtime Exceptions"），查看崩溃的完整调用栈，定位具体引发异常的代码位置
• 逐步简化页面：移除页面中的控件、绑定和业务逻辑，逐步排查引发崩溃的具体元素

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