MAUI项目点击按钮调用Navigation.PushAsync无法跳转新页面问题咨询

常见原因及修复方法 #

• 未配置导航根容器
  MAUI中使用Navigation.PushAsync的前提是应用根页面被包裹在NavigationPage中，很多新建项目或者迁移环境时会遗漏该配置。
  检查App.xaml.cs中的启动配置，修正为如下写法：

public App()
{
    InitializeComponent();
    // 必须套NavigationPage才能使用导航API
    MainPage = new NavigationPage(new MainPage());
}

• OnAppearing冗余线程调用导致阻塞
  你当前Page1的OnAppearing方法本身就是在UI线程触发的，额外嵌套MainThread.InvokeOnMainThreadAsync属于冗余操作，且async void方法如果存在隐式异常会被直接吞掉，导致页面加载卡住无反应。
  修正后的Page1代码如下：

public partial class Page1 : ContentPage
{
    public Page1()
    {
       InitializeComponent();
    }

    protected override async void OnAppearing()
    {
        base.OnAppearing();
        // 移除多余的主线程调用，直接执行异步方法
        await LoadRecipes();
    }

    private async Task LoadRecipes() 
    {
       // 后续业务代码
       await Task.CompletedTask;
    }
}

• 按钮事件未绑定
  检查触发跳转的按钮XAML是否正确关联了点击事件，示例：

<Button Text="跳转Page1" Clicked="OnButtonClicked"/>

• 异常被静默吞掉
  可以在跳转逻辑中添加异常捕获，判断是否是Page1初始化或者导航过程中抛出了未处理异常：

private async void OnButtonClicked(object sender, EventArgs e)
{
    try
    {
        await Navigation.PushAsync(new Page1());
    }
    catch (Exception ex)
    {
        // 输出异常信息排查问题
        System.Diagnostics.Debug.WriteLine($"跳转异常：{ex.Message}，堆栈：{ex.StackTrace}");
    }
}

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