Flutter从应用关闭状态处理Firebase动态链接时模态弹窗无法显示的问题

我之前也碰到过类似的冷启动导航异常，你的问题核心在于冷启动阶段Widget还没完全完成构建，导航栈的异步操作还没结束，就直接调用了模态弹窗方法，导致代码被跳过而没有执行。

问题分析 #

当应用从关闭状态启动时，initState会在Widget还没完全挂载到导航树时执行。你直接在initState里调用loadData去处理动态链接，此时：

1. Navigator.of(context).pushNamedAndRemoveUntil和pushNamed都是异步操作，但你没有等待它们完成就立刻调用showModalBottomSheet
2. 冷启动时context可能还处于不稳定状态，模态弹窗无法找到有效的上下文来渲染
3. 没有判断getInitialLink可能返回null的情况，一旦data为null会直接报错

解决方案 #

我们需要做两个关键调整：等待导航操作完成和确保Widget完全构建后再处理链接。

1. 修改handleLink方法，等待导航操作完成

把导航方法改为await，确保每个页面都被正确推入栈后再显示模态框，同时增加上下文有效性判断：

Future<void> handleLink(Uri deepLink) async {
  final context = navigatorKey.currentContext;
  if (context == null) {
    print("Context is not available yet");
    return;
  }
  
  final matchId = deepLink.queryParameters["match_id"];
  
  // 等待清空栈并跳转到AvailableMatches页面完成
  await Navigator.of(context).pushNamedAndRemoveUntil(
    AvailableMatches.routeName,
    (Route<dynamic> route) => false
  );
  
  // 等待跳转到MatchDetails页面完成
  await Navigator.of(context).pushNamed(
    MatchDetails.routeName,
    arguments: ScreenArguments(matchId, false)
  );
  
  // 此时导航栈稳定，再显示模态弹窗
  await showModalBottomSheet(
    context: context,
    builder: (context) => const Text("done")
  );
}

2. 在Widget构建完成后处理动态链接

使用WidgetsBinding.instance.addPostFrameCallback，确保在Widget第一次绘制完成后再执行链接处理，避免上下文不稳定的问题：

@override
void initState() {
  super.initState();
  initDynamicLinks();
  
  // 等待Widget完成构建后再加载链接数据
  WidgetsBinding.instance.addPostFrameCallback((_) async {
    await loadData(context);
  });
}

Future<void> loadData(BuildContext context) async {
  final PendingDynamicLinkData? data = await FirebaseDynamicLinks.instance.getInitialLink();
  if (data?.link != null) {
    await handleLink(data!.link);
  }
}

为什么这样有效？ #

• addPostFrameCallback会在Widget的第一帧绘制完成后触发，此时context已经完全挂载到导航树，状态稳定
• await导航方法确保每个页面跳转操作都完成，导航栈处于预期状态，模态弹窗能找到正确的上下文渲染
• 增加空值判断避免了潜在的空指针异常，代码鲁棒性更好

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