Flutter中重定向访问动态链接无法跳转目标页面问题

你的问题核心是：通过WebView预览页跳转动态链接时，应用能启动但无法跳转到目标页面，直接调用动态链接则正常。大概率是动态链接参数传递不完整、初始化时机问题或上下文未就绪导致的，以下是具体排查和修复步骤：

1. 先确认动态链接参数是否完整传递 #

在listenDynamicLinks中添加日志，打印接收到的完整链接信息，对比直接调用和WebView跳转后的参数差异：

Future<void> listenDynamicLinks() async {
    FirebaseDynamicLinks firebaseLink = FirebaseDynamicLinks.instance;
    final PendingDynamicLinkData? data = await firebaseLink.getInitialLink();
    final Uri? initialLink = data?.link;

    if (initialLink != null) {
      // 打印完整链接、权限、路径、参数
      print("Received initial link: $initialLink");
      print("Authority: ${initialLink.authority}");
      print("Path: ${initialLink.path}");
      print("Query params: ${initialLink.queryParameters}");
      moveByDynamicLink(initialLink);
    }

    firebaseLink.onLink.listen((PendingDynamicLinkData dynamicLink) async {
        final Uri curLink = dynamicLink.link;
        print("Received onLink: $curLink");
        moveByDynamicLink(curLink);
    });
}

如果WebView跳转后参数缺失（比如campaign_index或screen_id为空），说明预览页的重定向逻辑有问题，需确保运行按钮直接打开完整的原始动态链接，而非经过WebView修改后的链接。

2. 修复初始化时机与上下文问题 #

去掉不必要的延迟 #

你代码中的await Future.delayed(Duration(seconds: 1));完全没必要，反而可能导致初始链接的处理被延迟，错过Widget构建时机。直接删除这行代码。

确保上下文就绪后再跳转 #

冷启动时，context.vxNav可能还未完成Widget树挂载，直接调用push会失败。修改moveByDynamicLink，使用WidgetsBinding确保在Widget构建完成后执行跳转：

void moveByDynamicLink(Uri deepLink) async {
    try {
      if (deepLink.authority == "SECRET") {
        if (deepLink.path == "/qwefqwerqwerqer") {
          int? campaignIndex = int.tryParse(
              deepLink.queryParameters["campaign_index"].toString());

          if (campaignIndex != null) {
              // 等待Widget构建完成再执行跳转
              WidgetsBinding.instance.addPostFrameCallback((_) {
                context.vxNav.push(Uri.parse(NewCampaignDetailScreen.routeName),
                  params: {
                    "campaign_index": campaignIndex,
                    "hero_key": campaignIndex
                  });
              });
        } else if (deepLink.path == "/main") {
          int? screenId =
              int.tryParse(deepLink.queryParameters["screen_id"].toString());

              WidgetsBinding.instance.addPostFrameCallback((_) {
                context.vxNav.push(Uri.parse(HomeAdaptor.routeName),
                    params: {"screen_id": (screenId ?? 0).toString()});
              });
              return;
          
        }
      }
    } catch (e) {
      print("Dynamic link handle error: $e"); // 打印错误信息，排查问题
    }
  }

或者更稳妥的方式是使用全局导航键，避免依赖Widget上下文：

// 全局定义导航键
final GlobalKey<NavigatorState> navigatorKey = GlobalKey<NavigatorState>();

// 在MaterialApp中配置
MaterialApp(
  navigatorKey: navigatorKey,
  // ...其他配置
)

// 修改moveByDynamicLink中的跳转逻辑
navigatorKey.currentState?.pushNamed(NewCampaignDetailScreen.routeName, arguments: {
  "campaign_index": campaignIndex,
  "hero_key": campaignIndex
});

3. 检查WebView预览页的跳转逻辑 #

确保预览页的「运行按钮」是直接打开动态链接，而非在WebView内部跳转。使用launchUrl并指定externalApplication模式，强制唤起原生应用：

import 'package:url_launcher/url_launcher.dart';

// 运行按钮点击事件
onPressed: () async {
  final String dynamicLink = "你的完整动态链接地址";
  if (await canLaunchUrl(Uri.parse(dynamicLink))) {
    await launchUrl(
      Uri.parse(dynamicLink),
      mode: LaunchMode.externalApplication, // 强制打开外部应用
    );
  }
}

4. 捕获并打印错误信息 #

当前代码的catch块没有任何错误输出，这会导致你无法得知跳转失败的具体原因。添加日志打印，快速定位问题：

catch (e, stackTrace) {
  print("Dynamic link error: $e");
  print("Stack trace: $stackTrace");
}

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