MAUI Shell导航登录提示最佳实践：自动拦截未授权访问方案咨询

最优方案是利用MAUI Shell的**Navigating全局导航事件**做统一拦截，完全避免依赖页面/ViewModel生命周期方法的弊端（比如重写OnAppearing忘调base的问题），所有导航请求都会经过这个拦截点，逻辑更集中可靠。

具体实现步骤 #

1. 标记页面是否需要登录

用自定义特性（Attribute）给页面做标记，比继承BasePage更灵活，不需要强制所有页面继承基类：

[AttributeUsage(AttributeTargets.Class)]
public class RequiresAuthenticationAttribute : Attribute
{
    // 默认需要登录，不需要的页面手动设为false
    public bool IsRequired { get; set; } = true;
}

// 示例：受保护页面（需要登录）
[RequiresAuthentication]
public partial class ProfilePage : ContentPage { /* ... */ }

// 示例：公开页面（无需登录）
[RequiresAuthentication(IsRequired = false)]
public partial class HomePage : ContentPage { /* ... */ }

2. 在Shell中注册导航拦截逻辑

在你的AppShell类中，监听Navigating事件，在导航开始前校验登录状态：

public AppShell()
{
    InitializeComponent();
    Navigating += OnShellNavigating;
}

private async void OnShellNavigating(object sender, ShellNavigatingEventArgs e)
{
    // 跳过登录页的校验，避免循环跳转
    var targetRoute = e.Target.Location.OriginalString;
    if (targetRoute.Equals("//LoginPage", StringComparison.OrdinalIgnoreCase))
        return;

    // 获取目标页面的类型
    var targetPageType = Routing.GetRoutePage(e.Target.Location)?.GetType();
    if (targetPageType == null) return;

    // 读取页面的登录要求标记
    var authAttr = targetPageType.GetCustomAttribute<RequiresAuthenticationAttribute>();
    bool requiresAuth = authAttr?.IsRequired ?? true; // 默认需要登录

    // 替换成你的实际登录状态判断逻辑（比如全局静态变量、AuthService）
    bool isUserLoggedIn = App.Current.Properties.ContainsKey("LoggedInUser") 
                         && (bool)App.Current.Properties["LoggedInUser"];

    // 未登录且访问受保护页面时，拦截导航并跳转登录页
    if (requiresAuth && !isUserLoggedIn)
    {
        e.Cancel(); // 取消当前导航请求
        // 传递原目标路由，登录成功后跳转回去
        var returnUrl = Uri.EscapeDataString(targetRoute);
        await Shell.Current.GoToAsync($"//LoginPage?returnUrl={returnUrl}");
    }
}

3. 登录成功后跳转回原页面

在登录页的ViewModel中，处理登录成功后的跳转逻辑：

public partial class LoginViewModel : ObservableObject
{
    [QueryProperty(nameof(ReturnUrl), "returnUrl")]
    public string ReturnUrl { get; set; }

    [RelayCommand]
    public async Task Login()
    {
        // 执行实际登录逻辑（比如调用API验证账号密码）
        bool loginSuccess = await AuthService.ValidateCredentials(Username, Password);

        if (loginSuccess)
        {
            // 保存登录状态到全局
            App.Current.Properties["LoggedInUser"] = true;
            await App.Current.SavePropertiesAsync();

            // 跳转回用户原本要访问的页面，无返回路由则跳首页
            if (!string.IsNullOrEmpty(ReturnUrl))
            {
                await Shell.Current.GoToAsync(Uri.UnescapeDataString(ReturnUrl));
            }
            else
            {
                await Shell.Current.GoToAsync("//HomePage");
            }
        }
        else
        {
            // 登录失败提示
            await Shell.Current.DisplayAlert("错误", "账号或密码错误", "确定");
        }
    }
}

方案对比说明 #

• BaseViewModel/BasePage的OnAppearing方案：存在重写时遗漏调用base.OnAppearing()的风险，且校验逻辑分散在每个页面，维护成本高。
• Shell Navigating事件方案：全局统一拦截，所有导航请求必经此逻辑，不会出现遗漏；导航前拦截，避免页面闪跳；逻辑集中，便于后续修改登录规则。

内容的提问来源于stack exchange，提问作者L10.be