Xamarin Forms Shell异步配置加载初始化最佳实践及AppLink触发异常问题排查

针对你遇到的异步初始化冲突、AppLink跳转异常以及空指针问题，我来分享几个经过项目验证的解决方案，帮你优雅梳理整个启动流程：

一、彻底抛弃构造函数里的Fire-and-Forget异步调用 #

你最初在App构造函数中用InitApp().SafeFireAndForget()的方式确实是问题核心——构造函数会直接跳过异步任务，提前设置MainPage，导致AppShell在配置未就绪时就开始初始化。正确的思路是把异步初始化逻辑放到可控的异步流程中，确保配置加载完成后再初始化Shell。

二、启动页+异步初始化的标准化流程 #

我们可以用启动页作为初始页面，通过TaskCompletionSource跟踪初始化状态，让所有依赖配置的操作（包括AppLink跳转）都等待初始化完成，从根源避免时序冲突：

1. 改造App类，添加初始化等待机制 #

在App类中引入TaskCompletionSource来统一管理初始化状态，确保所有后续操作都能等待初始化完成：

public partial class App : Application
{
    private readonly TaskCompletionSource<bool> _initCompletionSource = new TaskCompletionSource<bool>();
    public Task InitializationCompleted => _initCompletionSource.Task;
    public bool IsInitiated { get; private set; }

    private ISettingsService _settingsService;
    private IDataService _dataService;
    public YourConfigurationType ActiveConfiguration { get; private set; }

    public App()
    {
        InitializeComponent();
        MainPage = new Splashscreen();
        // 后台启动初始化，不阻塞构造函数
        _ = InitializeAppAsync();
    }

    private async Task InitializeAppAsync()
    {
        try
        {
            if (IsInitiated) return;

            _settingsService = ViewModelLocator.Resolve<ISettingsService>();
            ViewModelLocator.UpdateDependencies(_settingsService.UseDemoMode);
            _dataService = ViewModelLocator.Resolve<IDataService>();
            ActiveConfiguration = await _dataService.GetActiveConfigurationAsync().ConfigureAwait(true);
            
            // 初始化主题（确保此时Application.Current已就绪）
            Application.Current.UserAppTheme = _settingsService.OSAppTheme;
            
            IsInitiated = true;
            _initCompletionSource.SetResult(true);
            
            // 仅当当前仍显示启动页时，才切换到Shell（避免AppLink提前切换的情况）
            if (MainPage is Splashscreen)
            {
                MainPage = new AppShellView();
            }
        }
        catch (Exception ex)
        {
            ErrorHandler(ex);
            _initCompletionSource.SetException(ex);
        }
    }
}

2. 修正AppLink请求的处理逻辑 #

由于OnAppLinkRequestReceived会优先于OnStart触发，我们需要让它先等待初始化完成，再执行页面跳转：

protected override async void OnAppLinkRequestReceived(Uri uri)
{
    try
    {
        // 等待初始化完成，确保配置和服务都已就绪
        await InitializationCompleted.ConfigureAwait(true);
        
        // 确保当前页面是Shell，否则切换过去
        if (!(MainPage is AppShellView))
        {
            MainPage = new AppShellView();
        }
        
        // 处理跳转逻辑
        var targets = uri.ToString().Replace(GlobalSetting.AppShortcutUriBase, "");
        var subtargets = targets.Split('/');
        App.CurrentPageId = new Guid(subtargets[0]);
        
        if (subtargets.Length > 1 && !string.IsNullOrWhiteSpace(subtargets[1]))
        {
            await Shell.Current.GoToAsync($"//{App.CurrentPageId}?buildingPartId={new Guid(subtargets[1])}").ConfigureAwait(true);
        }
        else
        {
            await Shell.Current.GoToAsync("//" + App.CurrentPageId).ConfigureAwait(true);
        }
    }
    catch (Exception ex)
    {
        ErrorHandler(ex);
    }
}

3. 简化OnStart方法 #

现在初始化逻辑已经由InitializeAppAsync独立处理，OnStart只需确保初始化完成即可，无需重复执行配置加载：

protected override async void OnStart()
{
    base.OnStart();
    try
    {
        await InitializationCompleted.ConfigureAwait(true);
        // 如果需要，可以在这里补充应用启动后的逻辑，比如同步最新配置
    }
    catch (Exception ex)
    {
        ErrorHandler(ex);
    }
}

三、关于App.Current空指针异常的原因 #

你遇到的App.Current为空问题，主要有两个原因：

1. 在应用生命周期极早期（比如初始化未完成时），App.Current的全局引用还未被框架正确赋值；
2. 页面切换过程中，应用的全局状态处于临时不稳定状态，直接访问App.Current会引发空引用。

解决办法是：

• 优先使用Application.Current（框架维护的全局可靠引用）替代App.Current；
• 确保所有需要访问应用全局属性的操作，都等待InitializationCompleted任务完成后再执行。

四、额外优化建议 #

• 启动页体验优化：在启动页添加加载动画或"正在初始化..."的提示文本，避免用户误以为应用卡顿；
• 异常降级处理：如果初始化失败（比如数据库读取错误），可以在启动页显示错误提示和重试按钮，提升应用容错性；
• 避免重复初始化：通过IsInitiated和TaskCompletionSource确保初始化逻辑只执行一次，即使多个生命周期方法同时触发。

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