Xamarin.Forms调用PopAsync等导航方法抛出索引越界异常

这个索引越界异常由导航栈操作不规范、Xamarin.Forms模态导航内部状态不同步共同导致，核心触发点如下：

• 所有模态导航操作均直接调用Application.Current.MainPage.Navigation执行，连续两次PushModalAsync时，如果前一个模态页尚未完成入栈、渲染的完整生命周期，第二次Push会直接修改同一个模态栈集合，导致Xamarin.Forms内部维护的栈计数和实际集合长度不一致，后续Pop操作按内部索引取元素时直接触发越界
• PopAsync是操作普通非模态导航栈的方法，你压入的两个页面都存在于模态栈（ModalStack）中，调用PopAsync本身就找不到对应页项，属于栈方法混用，必然触发异常
• 直接调用Navigation.RemovePage只会移除普通导航栈内的页面，完全无法操作模态栈中的内容，选错操作栈自然无法解决问题

紧急修复当前返回异常 #

不要从全局MainPage取导航对象执行返回操作，改用当前页面自身的Navigation属性，所有导航逻辑强制切到UI线程执行，执行前先校验栈长度避免越界：

// IntercomCallPage 页面内执行返回的正确代码
Device.BeginInvokeOnMainThread(async () =>
{
    // 校验模态栈长度，避免索引越界
    if (Navigation.ModalStack.Count >= 2)
    {
        await Navigation.PopModalAsync(animated: true);
    }
});

如果需要从IntercomCallPage直接回到初始的非模态页面，无需逐层弹出，直接清空模态栈即可：

Device.BeginInvokeOnMainThread(async () =>
{
    while (Navigation.ModalStack.Count > 0)
    {
        await Navigation.PopModalAsync(animated: false);
    }
});

长期规避方案 #

按照以下规范编写导航逻辑，可以彻底避免同类导航栈异常：

• 所有导航操作优先使用当前页面自身的Navigation属性，不要全局调用Application.Current.MainPage.Navigation，尤其是嵌套模态、嵌套导航页场景下，全局获取的导航对象大概率不是当前生效的导航容器
• 严格区分两个独立导航栈的操作方法，禁止混用：
  • 模态栈操作：使用PushModalAsync/PopModalAsync，对应栈集合为Navigation.ModalStack
  • 普通导航栈操作：使用PushAsync/PopAsync，对应栈集合为Navigation.NavigationStack
• 所有导航操作必须在UI线程执行，禁止在后台线程、Task.Run中直接调用导航方法，否则会出现栈状态更新不同步的问题
• 不要在页面构造函数、首次触发的OnAppearing方法中立刻执行导航操作，等待页面加载完成事件触发、或加100ms左右延时后再执行导航，避免生命周期冲突
• 新增导航操作信号量锁，防止同一时间多个导航操作并发修改栈集合：

// 全局导航锁，建议放在App.xaml.cs中声明
private static readonly SemaphoreSlim _navigationLock = new SemaphoreSlim(1, 1);

// 所有导航操作执行前先加锁
await _navigationLock.WaitAsync();
try
{
    // 此处编写Push/Pop等导航逻辑
}
finally
{
    _navigationLock.Release();
}

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