.NET MAUI异步初始化（async/await）异常问题求助

问题场景 #

使用.NET MAUI + .NET 7开发安卓/iOS应用（测试环境为Pixel 5安卓模拟器），需求是启动时自动完成认证等初始化操作，完成后跳转至主页面。目前实现方式为在启动页StartPage.xaml.cs的OnAppearing方法中调用ViewModel的初始化方法，但只要初始化方法中包含await异步操作（示例中用await Task.Delay(1000)模拟实际的服务器请求/认证逻辑），跳转后的主页面（加载带自定义标记的地图控件）就会抛出TaskCancelledException；注释掉该await语句则一切正常。

现有代码 #

启动页StartPage.xaml.cs #

protected override async void OnAppearing()
        => await _ViewModel.InitializeAsync();

ViewModel初始化代码 #

public async Task InitializeAsync()
{
    // 注释此行则正常，实际为应用初始化逻辑（服务器请求、认证等）
    await Task.Delay(1000);

    var user = new User();
    var parameters = NavigationService.GetParamsForObject(Tuple.Create("User", (object)user));

    // 跳转到主页面
    await NavigationService.GoToMainPage(parameters, true);
          
}

已尝试但未解决的方法 #

• 使用MainThread.InvokeOnMainThread()执行初始化逻辑
• 使用Dispatcher调度异步操作
• 捕获TaskCancelledException，但引发异常行为
• 重写OnNavigatedFrom替代OnAppearing执行初始化

问题原因与解决方案 #

核心问题 #

问题出在标记为async void的OnAppearing方法：
OnAppearing是UI生命周期方法，当标记为async void后，内部await操作挂起时方法会立即返回，UI线程继续执行后续逻辑。待await完成后执行页面跳转时，原启动页的导航上下文可能已被销毁或处于不稳定状态，导致后续导航操作或主页面控件的加载任务被取消，最终触发TaskCancelledException。

正确实现方式 #

1. 将初始化逻辑移至应用启动入口（推荐）

把初始化与导航逻辑移到App.xaml.cs的OnStart方法中，通过异步包装避免阻塞UI：

protected override async void OnStart()
{
    base.OnStart();
    await PerformInitializationAndNavigation();
}

private async Task PerformInitializationAndNavigation()
{
    // 执行实际初始化逻辑（认证、服务器请求等）
    await Task.Delay(1000);

    var user = new User();
    var parameters = NavigationService.GetParamsForObject(Tuple.Create("User", (object)user));
    await NavigationService.GoToMainPage(parameters, true);
}

2. 优化OnAppearing中的异步调用

若必须在OnAppearing中处理，可通过await Task.Yield()确保UI线程先完成当前渲染，再执行异步操作：

protected override async void OnAppearing()
{
    base.OnAppearing();
    // 让UI线程优先完成当前页面渲染
    await Task.Yield();
    await _ViewModel.InitializeAsync();
}

同时需确保NavigationService.GoToMainPage方法在UI线程执行，避免跨线程导航问题。

3. 主页面控件适配

主页面的地图控件抛出异常，本质是导航跳转导致启动页上下文取消影响了控件加载。需确保主页面控件的初始化逻辑独立，不依赖启动页的任何上下文，加载时检查任务状态避免被取消。

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