.NET Maui应用启动时指定初始导航页面的最佳实现位置

下面几个位置是启动时仅执行一次、且能确保导航成功的最佳选择，按需挑选：

1. App类的OnStart方法 #

这是应用启动后第一个触发的生命周期方法，此时AppShell已经完成初始化，完全可以执行导航逻辑。

代码示例：

protected override void OnStart()
{
    base.OnStart();
    // 从本地存储读取状态，比如用Preferences
    var isLoggedIn = Preferences.Get("IsLoggedIn", false);
    
    // 导航必须在UI线程执行，所以用MainThread包裹
    MainThread.BeginInvokeOnMainThread(async () =>
    {
        if (isLoggedIn)
        {
            await Shell.Current.GoToAsync("//MainTab");
        }
        else
        {
            await Shell.Current.GoToAsync("//LoginPage");
        }
    });
}

这里的代码只会在应用启动时跑一次，不会重复触发。

2. AppShell的OnNavigatedTo方法（加单次执行标记） #

如果想在Shell层面处理导航逻辑，可以用这个方法，但要注意它会在每次Shell被导航到时触发，所以得加个标记确保只跑一次。

代码示例：

private bool _hasDoneInitialNavigation = false;

protected override async void OnNavigatedTo(NavigatedToEventArgs args)
{
    base.OnNavigatedTo(args);
    // 已经执行过就直接返回
    if (_hasDoneInitialNavigation) return;
    
    _hasDoneInitialNavigation = true;
    var isLoggedIn = Preferences.Get("IsLoggedIn", false);
    
    if (isLoggedIn)
    {
        await GoToAsync("//MainTab");
    }
    else
    {
        await GoToAsync("//LoginPage");
    }
}

3. MauiProgram中的启动初始化逻辑 #

如果需要先做一些后台初始化工作（比如加载配置、同步数据）再导航，这种方式更合适。

先写个初始化服务：

public class AppInitializer
{
    public async Task DoInitialSetupAsync()
    {
        // 先做你的初始化操作，比如读取本地缓存、初始化数据库等
        var isLoggedIn = Preferences.Get("IsLoggedIn", false);
        
        // 导航必须在UI线程执行
        await MainThread.InvokeOnMainThreadAsync(async () =>
        {
            if (isLoggedIn)
            {
                await Shell.Current.GoToAsync("//MainTab");
            }
            else
            {
                await Shell.Current.GoToAsync("//LoginPage");
            }
        });
    }
}

然后在MauiProgram里注册并调用：

builder.Services.AddSingleton<AppInitializer>();

var app = builder.Build();
// 获取初始化服务并执行
var initializer = app.Services.GetRequiredService<AppInitializer>();
await initializer.DoInitialSetupAsync();

return app;

几个关键注意点 #

• 导航路径要写对：用Shell的绝对路径（比如//MainTab），避免相对路径导致的跳转失败。
• 必须在UI线程导航：所有和UI相关的操作（包括导航）都要放在MainThread的方法里，不然会报错。
• 加异常处理：导航时可能遇到路径不存在的情况，建议套个try-catch块，避免应用崩溃。

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