.NET8 MAUI中MauiCommunityToolkit Popup调用Close后无法正常隐藏

1. 必须在主线程执行UI操作 #

MAUI所有UI操作（包括弹窗关闭）都得在主线程跑。如果你的数据加载是用Task.Run这类后台线程执行的，直接调用ClosePopup会触发跨线程操作，导致弹窗无法正常关闭。

修复代码：

public void ClosePopup(Popup popup)
{
    if (popup == null) return;
    // 切换到主线程执行关闭逻辑
    MainThread.BeginInvokeOnMainThread(() =>
    {
        popup.Close();
    });
}

2. 保证Popup实例一致 #

调用ClosePopup时，必须传入之前显示的同一个LoadingPopup实例。如果实例被重新创建或者引用丢失，关闭操作就会失效。

示例代码（ViewModel中保存实例）：

// ViewModel里声明字段存弹窗实例
private LoadingPopup _loadingPopup;

// 显示弹窗时保存实例
_loadingPopup = new LoadingPopup();
_popupService.ShowPopup(_loadingPopup);

// 关闭时用同一个实例
if (_loadingPopup != null)
{
    _popupService.ClosePopup(_loadingPopup);
    _loadingPopup = null; // 用完释放引用
}

3. 检查Popup的背景关闭设置 #

你提到点击屏幕才能移除弹窗，说明IsLightDismissEnabled默认是true（允许点击背景关闭）。如果不需要这个功能，可以显式关闭，同时确保关闭逻辑直接触发：

在LoadingPopup的构造函数里添加：

public LoadingPopup()
{
    InitializeComponent();
    // 禁止点击背景关闭弹窗，避免干扰主动关闭逻辑
    IsLightDismissEnabled = false;
}

4. 优化PopupService的页面引用逻辑 #

当前PopupService里的page引用可能不是显示弹窗的当前页面（比如页面导航后，引用还是旧页面），改成动态获取当前活跃页面更可靠：

public class PopupService : IPopupService
{
    private Page GetCurrentPage()
    {
        var currentPage = Application.Current?.MainPage;
        // 处理导航页面嵌套
        while (currentPage is NavigationPage navPage)
        {
            currentPage = navPage.CurrentPage;
        }
        // 处理Shell页面嵌套
        while (currentPage is Shell shell)
        {
            currentPage = shell.CurrentItem?.CurrentPage;
        }
        return currentPage ?? throw new NullReferenceException("无法获取当前页面");
    }

    public void ClosePopup(Popup popup)
    {
        if (popup == null) return;
        MainThread.BeginInvokeOnMainThread(() =>
        {
            popup.Close();
        });
    }

    public void ShowPopup(Popup popup)
    {
        var currentPage = GetCurrentPage();
        MainThread.BeginInvokeOnMainThread(() =>
        {
            currentPage.ShowPopup(popup);
        });
    }
}

这里去掉了Init方法，每次操作都动态获取当前页面，避免页面导航后引用失效的问题。

5. 确认弹窗关闭时机 #

要等数据加载完全完成后再调用关闭方法，避免异步操作未结束就触发关闭，导致逻辑混乱。示例：

// 模拟后台加载数据
await Task.Run(() =>
{
    // 你的数据加载逻辑
});
// 加载完成后再关闭弹窗
_popupService.ClosePopup(_loadingPopup);

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