MAUI中在OnAppearing内调用ShowPopup无法打开弹窗的问题

开发者阿泽

2026-7-28

解决MAUI OnAppearing中调用ShowPopup抛出MauiContext异常的问题

问题原因

OnAppearing时机过早：当OnAppearing触发时，页面的MauiContext尚未完全初始化完成，直接调用ShowPopup会抛出Could not locate MauiContext异常。
后台线程无法操作UI：Task.Run内的代码运行在后台线程，而弹窗属于UI操作，必须在主线程执行，因此调用无效果。

解决方案

方案1：改用异步OnAppearing并等待UI初始化

将OnAppearing改为异步方法，通过await Task.Yield()让UI线程先完成当前渲染周期，确保MauiContext已就绪：

protected override async void OnAppearing()
{
    base.OnAppearing();
    // 等待UI线程完成页面初始化
    await Task.Yield();

    var loadingPopup = new SpinnerPopup();
    // 启动弹窗显示（无需等待弹窗完全显示）
    _ = ShowPopupAsync(loadingPopup);

    try
    {
        // 执行数据加载逻辑
        await ((FilesInMediaStoreViewModel)BindingContext).LoadDataAsync();
    }
    finally
    {
        // 加载完成后关闭弹窗
        loadingPopup.Close();
    }
}

方案2：使用Page的Loaded事件

Loaded事件在页面完全渲染完成后触发，此时MauiContext已完全初始化，是更安全的时机：

在XAML中添加Loaded事件绑定：

<ContentPage x:Class="FullSail.Views.FilesInMediaStorePage"
             xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             Loaded="OnPageLoaded">
    <!-- 页面内容 -->
</ContentPage>

后台代码实现事件处理：

private async void OnPageLoaded(object sender, EventArgs e)
{
    var loadingPopup = new SpinnerPopup();
    _ = ShowPopupAsync(loadingPopup);

    try
    {
        await ((FilesInMediaStoreViewModel)BindingContext).LoadDataAsync();
    }
    finally
    {
        loadingPopup.Close();
    }
}