.NET MAUI应用：实现启动必登与TabBar正常运行并解决白屏闪烁

问题根源分析 #

直接替换Application.Current.MainPage为新的AppShell实例会触发整个Shell页面树的重新初始化与渲染，这是导致白屏闪烁的核心原因。正确的思路是保持MainPage始终为同一个AppShell实例，通过Shell的原生导航系统控制登录页与TabBar内容的切换。

解决方案步骤 #

1. 配置Shell路由与结构

在AppShell中注册所有页面的路由，并默认保持TabBar可见性可控：

<?xml version="1.0" encoding="UTF-8" ?>
<Shell xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
       xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
       xmlns:mct="clr-namespace:CommunityToolkit.Maui.Behaviors;assembly=CommunityToolkit.Maui"
       xmlns:views="clr-namespace:MobileControlerMAUI.Views"
       x:Class="MobileControlerMAUI.AppShell"
       Shell.NavBarIsVisible="False">

    <Page.Behaviors>
        <mct:StatusBarBehavior x:Name="statusBar" StatusBarColor="Black" StatusBarStyle="LightContent"/>
    </Page.Behaviors>

    <Shell.Resources>
        <Style TargetType="TabBar">
            <Setter Property="Shell.TabBarBackgroundColor" Value="#1a237e" />
            <Setter Property="Shell.TabBarForegroundColor" Value="#FFFFFF" />
            <Setter Property="Shell.TabBarTitleColor" Value="#FFFFFF" />
            <Setter Property="Shell.TabBarUnselectedColor" Value="#B0BEC5" />
        </Style>
    </Shell.Resources>

    <TabBar x:Name="MainTabBar">
        <Tab x:Name="NotificationTab" Icon="notification_icon.png">
            <ShellContent Route="NotificationPage" ContentTemplate="{DataTemplate views:NotificationPage}" />
        </Tab>
        <Tab x:Name="HomeTab" Icon="home_icon.png">
            <ShellContent Route="HomePage" ContentTemplate="{DataTemplate views:HomePage}" />
        </Tab>
    </TabBar>
</Shell>

在AppShell.xaml.cs中注册路由并处理启动逻辑：

public partial class AppShell : Shell
{
    public AppShell()
    {
        InitializeComponent();
        // 注册页面路由
        Routing.RegisterRoute(nameof(LoginPage), typeof(LoginPage));
    }

    protected override async void OnAppearing()
    {
        base.OnAppearing();
        // 启动时以模态方式打开登录页，避免修改导航栈导致的闪烁
        await Shell.Current.ShowModalAsync(nameof(LoginPage));
    }
}

2. 修改登录逻辑，避免替换MainPage

将登录成功后的页面切换改为关闭模态登录页，直接显示TabBar内容：

[RelayCommand]
private async Task Login()
{
    try
    {
        // 执行认证逻辑（如接口请求、本地存储Token等）

        await Shell.Current.DisplayAlert("Success", "登录成功", "OK");
        
        // 关闭模态登录页，自动回到AppShell的TabBar界面
        await Shell.Current.CloseModalAsync();
        
        // 可选：指定默认显示的Tab页
        Shell.Current.CurrentItem = MainTabBar.Items.FirstOrDefault(t => t.Route == nameof(NotificationPage));
    }
    catch (Exception ex)
    {
        await Shell.Current.DisplayAlert("Error", $"{ex.Message}", "ОК");
    }
}

3. 确保应用启动直接进入登录页

在App.xaml.cs中固定MainPage为AppShell实例，无需动态替换：

public App()
{
    InitializeComponent();
    // 始终保持MainPage为同一个AppShell实例
    MainPage = new AppShell();
}

方案优势 #

• 避免了MainPage替换导致的页面重新渲染，彻底解决白屏闪烁问题；
• 利用Shell原生模态导航，登录页与TabBar的切换过渡流畅；
• 导航栈逻辑清晰，登录后无法返回登录页（模态关闭后栈中无登录页记录）；
• TabBar功能完全不受影响，登录后可正常切换标签页。

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