MAUI .NET8中导航报错‘Platform view cannot be found’的解决咨询

问题根源分析 #

你遇到的“Platform view cannot be found”错误，本质是重复使用了已被销毁的页面实例：当调用PopModalAsync()后，模态页面会被框架销毁并释放其平台视图资源。如果DI容器注册页面时用了Singleton（甚至错误的Scoped），再次获取该实例时，它的平台视图已经不存在，就会触发这个错误。同时，直接替换MainPage的方式会破坏导航栈的统一性，导致导航逻辑混乱。

最佳实现方案 #

1. 统一导航容器，规范启动逻辑 #

不管是否需要认证，都用NavigationPage作为根容器，让所有导航操作基于统一的导航栈：

public App(UserSettings settings, IServiceProvider services)
{
    InitializeComponent();

    // 注册路由（按需使用）
    Routing.RegisterRoute(nameof(LoginPage), typeof(LoginPage));
    Routing.RegisterRoute(nameof(DictionaryList), typeof(DictionaryList));

    if (settings.UseBiometric || settings.IsPasswordRequired)
    {
        // 用NavigationPage包裹LoginPage作为根容器
        MainPage = new NavigationPage(services.GetService<LoginPage>());
    }
    else
    {
        // AppShell本身是导航容器，直接作为根
        MainPage = services.GetService<AppShell>();
    }
}

2. 正确注册页面的依赖注入 #

确保所有页面都注册为Transient，这样每次获取都是全新实例，避免复用已销毁的对象：
在MauiProgram.cs中配置：

builder.Services.AddTransient<LoginPage>();
builder.Services.AddTransient<MainPage>();
builder.Services.AddTransient<DictionaryList>();
builder.Services.AddTransient<AppShell>();

3. 认证成功后的页面切换 #

认证通过后，不要直接替换MainPage，而是通过导航栈清空并跳转，保持导航逻辑一致：
在LoginPage的认证成功方法中：

// 清空当前导航栈，跳转至AppShell
await Navigation.PopToRootAsync();
await Navigation.PushAsync(_services.GetService<AppShell>());

// 若需要完全重置导航结构，也可直接替换根容器
// Application.Current.MainPage = _services.GetService<AppShell>();

4. 模态页面的正确导航与关闭 #

从MainPage打开模态页面时，确保每次获取新实例：

// 每次打开都获取全新的Transient实例
await Navigation.PushModalAsync(_services.GetService<DictionaryList>(), true);

关闭模态页面时直接调用：

await Navigation.PopModalAsync();

框架会自动销毁当前模态页面实例，下次打开时获取新实例就不会出现资源已释放的问题。

额外注意事项 #

• 避免直接操作MainPage切换页面，除非是需要完全重置导航结构的场景。
• 若使用AppShell路由导航，可在OnNavigating事件中添加认证守卫，拦截未授权的路由跳转。
• 页面状态建议放在ViewModel中管理，让页面作为无状态的视图载体，减少对页面实例的依赖。

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