.NET MAUI中使用NavigationPage导航遇到IPage报错该如何解决？

报错根因 #

你遇到的NavigationPage未实现IPage接口报错，本质是类型赋值位置错误：

• NavigationPage本身是.NET MAUI中标准的跨平台页面容器，完整实现了所有跨平台页面所需的接口，不存在自身未实现接口的问题
• 你之前在MainWindow构造函数中给Page属性赋值的写法，本身就适配错了目标位置：这个Page属性是平台特定的窗口属性，要求传入实现了平台级IPage接口的对象，和跨平台NavigationPage类型不匹配，才会触发接口实现的报错
• 最开始直接调用Navigation.PushAsync失效的原因，是此时MainPage没有被嵌套在具备导航栈能力的容器（比如NavigationPage、Shell）中，没有可用的导航上下文可以执行页面推送操作

方案1：传统NavigationPage导航（兼容Xamarin.Forms写法，无Shell依赖） #

适合习惯原有导航栈逻辑、不想引入Shell架构的开发场景，配置步骤为：

• 移除默认项目模板自动生成的AppShell.xaml、AppShell.xaml.cs文件
• 重写App类的CreateWindow方法，将NavigationPage作为跨平台窗口的根内容传入：

public partial class App : Application
{
    public App()
    {
        InitializeComponent();
    }

    protected override Window CreateWindow(IActivationState? activationState)
    {
        // 直接将NavigationPage实例作为Window的根内容传入，不要在MainWindow的平台属性上赋值
        return new Window(new NavigationPage(new MainPage()));
    }
}

配置完成后，你之前编写的按钮点击导航代码可以直接正常运行，无需修改：

private async void btnNav_Clicked(object sender, EventArgs e)
{
    await Navigation.PushAsync(new Pages.Nav1Page());
}

方案2：Shell架构下的导航实现（MAUI官方推荐方式） #

MAUI默认模板采用Shell作为应用导航根容器，本身已内置完整的导航栈能力，不需要手动嵌套NavigationPage，配置步骤为：

• 打开AppShell.xaml，在Shell路由节点中注册需要跳转的目标页面：

<Shell xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
       xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
       xmlns:pages="clr-namespace:MauiApp1.Pages"
       xmlns:local="clr-namespace:MauiApp1">
    <!-- 主页路由 -->
    <ShellContent Route="MainPage" ContentTemplate="{DataTemplate local:MainPage}" />
    <!-- 注册跳转目标页路由 -->
    <ShellContent Route="Nav1Page" ContentTemplate="{DataTemplate pages:Nav1Page}" />
</Shell>

• 修改MainPage的按钮点击逻辑，直接调用Shell导航API即可：

private async void btnNav_Clicked(object sender, EventArgs e)
{
    await Shell.Current.GoToAsync(nameof(Nav1Page));
}

常见注意事项 #

• 不要同时混用Shell根容器和手动创建的NavigationPage，否则会出现导航栈断裂、页面跳转失效的问题
• 如果使用传统NavigationPage架构，需确保所有需要PushAsync跳转的页面都在NavigationPage的控件树层级内，才能正常获取到可用的Navigation属性实例

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