.NET MAUI中基于Deep Link跳转指定页面的生命周期方法及问题排查

核心问题分析 #

你之前的实现存在两个关键问题：

1. 复用页面实例导致渲染异常：在OnResume中直接推送构造时注入的同一个CheckoutSuccess实例，该实例可能已被导航栈弹出并进入销毁状态，再次推送会导致页面内容无法正常渲染。
2. 生命周期方法误用：OnResume会在应用每次从后台恢复时触发，并非仅在深度链接打开时执行，导致不必要的跳转逻辑触发。

正确实现步骤 #

1. Android端捕获深度链接（MainActivity） #

在MainActivity中通过OnNewIntent处理应用已启动时的深度链接，OnCreate处理冷启动场景（应用未启动时点击链接），这是Android端捕获深度链接的标准入口：

[Activity(Label = "@string/app_name", MainLauncher = true, ConfigurationChanges = ConfigChanges.ScreenSize | ConfigChanges.Orientation | ConfigChanges.UiMode | ConfigChanges.ScreenLayout | ConfigChanges.SmallestScreenSize | ConfigChanges.Density)]
public class MainActivity : MauiAppCompatActivity
{
    protected override void OnNewIntent(Intent intent)
    {
        base.OnNewIntent(intent);
        if (intent.Data != null)
        {
            var deepLinkUrl = intent.Data.ToString();
            (Application.Current as App)?.HandleDeepLink(deepLinkUrl);
        }
    }

    protected override void OnCreate(Bundle savedInstanceState)
    {
        base.OnCreate(savedInstanceState);
        if (Intent.Data != null)
        {
            var deepLinkUrl = Intent.Data.ToString();
            (Application.Current as App)?.HandleDeepLink(deepLinkUrl);
        }
    }
}

2. App层处理导航逻辑 #

修改App.xaml.cs，移除OnResume中的硬编码跳转，添加专门的深度链接处理方法，并通过依赖注入获取新的页面实例：

public partial class App : Application
{
    private readonly IServiceProvider _serviceProvider;
    private readonly NavigationPage _navigationPage;

    public App(IServiceProvider serviceProvider, NavigationPage navigationPage)
    {
        InitializeComponent();
        _serviceProvider = serviceProvider;
        _navigationPage = navigationPage;
        
        // 初始化首页
        var landingPage = _serviceProvider.GetRequiredService<LandingPage>();
        _navigationPage.PushAsync(landingPage);
        MainPage = _navigationPage;
    }

    // 深度链接处理核心方法
    public async void HandleDeepLink(string deepLinkUrl)
    {
        // 根据URL匹配跳转目标，示例：识别支付成功链接
        if (deepLinkUrl.Contains("checkout/success"))
        {
            var nav = MainPage.Navigation;
            await nav.PopToRootAsync(animated: true);
            // 获取新的CheckoutSuccess实例（依赖注入需注册为Transient）
            var successPage = _serviceProvider.GetRequiredService<CheckoutSuccess>();
            await nav.PushAsync(successPage, animated: true);
        }
        // 可扩展其他深度链接场景
        // else if (deepLinkUrl.Contains("user/profile")) { ... }
    }

    protected override void OnResume()
    {
        base.OnResume();
        // 此处仅处理通用后台恢复逻辑，不要添加硬编码跳转
    }
}

3. 配置依赖注入模式 #

在MauiProgram.cs中，将页面注册为Transient模式，确保每次获取都是全新实例：

public static MauiApp CreateMauiApp()
{
    var builder = MauiApp.CreateBuilder();
    builder
        .UseMauiApp<App>()
        .ConfigureFonts(fonts =>
        {
            fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
        });

    // 注册页面与服务
    builder.Services.AddTransient<LandingPage>();
    builder.Services.AddTransient<CheckoutSuccess>();
    builder.Services.AddSingleton<NavigationPage>();

    return builder.Build();
}

关键说明 #

• 禁止复用页面实例：页面被弹出导航栈后，内部控件可能已被销毁，再次推送会导致内容不显示，每次跳转都应获取新实例。
• 精准触发导航：仅在检测到对应深度链接时执行跳转，避免OnResume触发不必要的页面切换。
• 覆盖所有入口：同时处理冷启动和应用已启动时的深度链接场景，确保所有跳转路径都被覆盖。

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