.NET MAUI：多次切换App的MainPage引发异常问题求助

问题根源 #

直接通过替换App.MainPage实现导航的方式，绕开了MAUI内置的生命周期管理机制。在Android平台上，旧页面的原生视图仍被某个父容器持有（即使MAUI层的Parent/RealParent显示为null），导致系统检测到视图重复绑定，抛出IllegalStateException。

推荐解决方案：改用MAUI内置导航机制 #

MAUI提供了NavigationPage和Shell两种成熟的导航方案，能自动处理视图的生命周期和原生层引用清理，从根源避免这类问题。

用NavigationPage实现流程 #

1. 启动时初始化根导航页：

   public App()
   {
       InitializeComponent();
       // 用NavigationPage包裹登录页作为初始根
       MainPage = new NavigationPage(new LoginPage());
   }
   

2. 登录成功后切换到TabbedPage：

   // 在LoginPage的登录按钮点击事件中
   await Navigation.PopToRootAsync();
   await Navigation.PushAsync(new MainTabbedPage());
   

3. 从TabbedPage打开详情页：

   // 在TabbedPage的子页面中
   await Navigation.PushAsync(new DetailPage());
   

4. 详情页返回主视图：

   // 在DetailPage的取消按钮点击事件中
   await Navigation.PopAsync();
   

若坚持自定义ShowPage方法的修复方案 #

如果必须保留自定义导航逻辑，需要手动清理旧页面的原生视图引用：

public void ShowPage(Page page)
{
    if (MainPage != null)
    {
        // 针对Android平台清理原生视图引用
        #if ANDROID
        var nativeOldView = MainPage.Handler?.PlatformView as Android.Views.View;
        nativeOldView?.Parent?.RemoveView(nativeOldView);
        #endif

        // 断开MAUI层的页面关联
        MainPage.Parent = null;
        MainPage = null;
    }
    MainPage = page;
}

说明 #

• 借助Handler.PlatformView可以获取到Android平台的原生视图，通过它的Parent调用RemoveView，彻底解除原生层的父容器绑定。
• 先将MainPage置为null，再赋值新页面，确保MAUI层的引用也被正确清理。

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