C# MAUI 8 iOS端页面导航时出现索引越界异常求助

问题概述 #

基于C# MAUI 8 + Shell框架开发的应用，Android端运行正常，但部署到iPhone/iOS模拟器（VS2022配对Mac+XCode）时，执行A → PushAsync → B → PushAsync → C → PopAsync导航流程，会触发索引越界异常：

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

异常来源为Microsoft.IOS，堆栈跟踪指向iOS程序入口Program.Main，替换为GoToAsync方法后问题依旧。

相关核心代码片段：

iOS Program.cs #

public class Program
{
    static void Main(string[] args)
    {
        UIApplication.Main(args, null, typeof(AppDelegate));
    }
}

AppShell后端代码 #

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

AppShell XAML #

<?xml version="1.0" encoding="UTF-8" ?>
<Shell
    x:Class="MyApp.AppShell"
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    xmlns:local="clr-namespace:MyApp"
    xmlns:views="clr-namespace:MyApp.Views"
    Shell.TabBarIsVisible="False">

    <ShellContent
        Title="Login"
        ContentTemplate="{DataTemplate views:LoginPage}"
        FlyoutItemIsVisible="False"
        Route="LoginPage"
        Shell.FlyoutBehavior="Disabled" />
</Shell>

MauiProgram服务注册部分 #

builder.Services.AddSingleton<AppShell>();
builder.Services.AddTransient<LoginPage>();
builder.Services.AddSingleton<PageB>();
builder.Services.AddTransient<PageC>();

排查与调试步骤 #

1. 启用iOS详细调试日志 #

在VS2022中进入项目属性 → iOS选项 → 调试，勾选启用调试输出和启用详细日志记录，运行时观察输出窗口的导航相关日志，确认页面栈的数量、元素变化是否符合预期。

2. 手动校验页面栈状态 #

在触发PopAsync前，添加代码打印当前页面栈详情，确认栈结构是否正常：

// 在PageC的Pop操作前执行
var navigationStack = Shell.Current.Navigation.NavigationStack;
Console.WriteLine($"当前页面栈数量：{navigationStack.Count}");
foreach (var page in navigationStack)
{
    Console.WriteLine($"页面：{page.GetType().Name}");
}
await Shell.Current.Navigation.PopAsync();

确保Pop操作前栈中至少存在2个页面（B和C），避免重复Pop或栈状态异常。

3. 调整页面服务注册生命周期 #

注意到PageB是单例注册，而iOS对页面实例的生命周期管理更严格，单例页面多次入栈易引发栈状态冲突。尝试将PageB改为瞬态注册：

builder.Services.AddTransient<PageB>();

4. 完善Shell路由注册 #

当前仅注册了LoginPage的路由，未注册的页面直接使用PushAsync可能导致iOS栈管理异常。在AppShell构造函数中添加路由注册：

public AppShell()
{
    InitializeComponent();
    Routing.RegisterRoute(nameof(PageB), typeof(PageB));
    Routing.RegisterRoute(nameof(PageC), typeof(PageC));
}

之后使用Shell标准路由导航：

// 跳转页面
await Shell.Current.GoToAsync(nameof(PageB));
await Shell.Current.GoToAsync(nameof(PageC));
// 返回上一页
await Shell.Current.GoToAsync("..");

5. 排查页面生命周期的异常操作 #

检查PageC的OnDisappearing或OnNavigatingFrom方法中是否存在修改页面栈的操作（比如主动Pop、修改导航栈集合），这类操作会破坏iOS导航栈的内部状态，引发索引越界。

6. 更新相关组件版本 #

确认VS2022、MAUI SDK、XCode为最新稳定版，旧版本可能存在已知的iOS导航栈兼容性Bug，更新后可解决部分问题。

可能的根本原因 #

iOS导航栈实现与Android存在差异，Shell框架在iOS上对页面实例的生命周期管理更严格：

• 单例页面多次入栈会导致栈中存在同一实例的重复引用，引发内部状态冲突
• 未通过Shell路由注册的页面，PushAsync时未被正确纳入Shell栈管理体系
• 导航操作未在主线程执行（虽MAUI默认调度，但需确认异步操作是否引发线程异常）

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