MAUI Blazor安卓应用如何按业务逻辑拦截系统返回按钮

所有JS层面的history拦截、popstate监听方案都会触发Blazor WebView的历史栈变动，必然出现页面重载、闪烁问题，要实现原生级无感知拦截，直接在安卓宿主Activity层拦截系统返回事件即可，完全不会触发Blazor层的任何渲染或路由变动。

步骤1：安卓原生层拦截返回事件 #

直接重写MainActivity的返回按下方法，这是安卓系统官方的返回事件入口，物理返回键、系统导航栏软返回键的事件都会走到这里，拦截后不会有任何系统级动画或副作用。

1. 打开项目下Platforms/Android/MainActivity.cs文件
2. 新增全局控制标记，重写OnBackPressed逻辑，代码如下：

using Android.App;
using Android.Content.PM;
using Microsoft.Maui;

namespace YourAppName.Platforms.Android;

[Activity(Theme = "@style/Maui.SplashTheme", MainLauncher = true, ConfigurationChanges = ConfigChanges.ScreenSize | ConfigChanges.Orientation | ConfigChanges.UiMode | ConfigChanges.ScreenLayout | ConfigChanges.SmallestScreenSize | ConfigChanges.Density)]
public class MainActivity : MauiAppCompatActivity
{
    /// <summary>
    /// 全局返回导航控制开关：false=拦截返回事件，true=执行默认返回逻辑
    /// </summary>
    public static bool AllowBackNavigation { get; set; } = true;

    public override void OnBackPressed()
    {
        if (AllowBackNavigation)
        {
            base.OnBackPressed();
        }
        // 不满足放行条件时直接不执行任何逻辑，事件被完全消费，无任何界面响应
    }
}

步骤2：Blazor业务层同步拦截状态 #

因为MAUI Blazor的原生层和Blazor层运行在同一进程，不需要编写JS互操作逻辑，直接在Razor页面里访问原生层的静态标记，就能根据业务状态动态控制是否允许返回。
以page2页面为例，代码参考：

@page "/page2"
@implements IDisposable
@* 引入安卓Activity命名空间，加条件编译避免其他平台编译报错 *@
#if ANDROID
@using YourAppName.Platforms.Android
#endif

<!-- 你的业务UI，比如待提交的表单、未完成的流程 -->
<div>当前页面流程未完成时无法返回</div>
<button @onclick="CompleteBusiness">完成流程后允许返回</button>

@code {
    protected override void OnInitialized()
    {
        // 进入当前页面默认拦截返回
#if ANDROID
        MainActivity.AllowBackNavigation = false;
#endif
        base.OnInitialized();
    }

    private void CompleteBusiness()
    {
        // 你的业务条件满足时，放开返回拦截
#if ANDROID
        MainActivity.AllowBackNavigation = true;
#endif
    }

    public void Dispose()
    {
        // 离开页面时重置状态，避免影响其他页面的返回逻辑
#if ANDROID
        MainActivity.AllowBackNavigation = true;
#endif
    }
}

避坑说明 #

• 不要使用Blazor自带的NavigationManager.LockNavigation方法，该方法只能拦截Blazor内部触发的代码导航，完全无法捕获安卓系统级的返回按钮事件。
• 不要使用任何JS侧的拦截方案，包括监听beforeunload、popstate事件、修改history栈等，这类方案触发时WebView已经执行了历史栈回退逻辑，必然导致页面重载、闪烁。
• 该方案对物理返回键、系统导航栏软返回键、手势返回（安卓10+全手势导航）全部生效，拦截时用户完全感知不到事件被处理，和返回按钮未被按下的体验完全一致。
• 所有安卓平台专属代码都用#if ANDROID条件编译包裹，不会影响Windows、iOS等其他平台的编译运行。

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