如何无需context通过deep link打开bottom sheet

核心实现逻辑是通过全局导航能力获取稳定的根路由上下文，完全脱离页面级context传递限制，全版本Flutter通用，具体实现步骤如下：

1. 初始化全局导航Key #

在App全局作用域定义根导航Key，绑定到App入口的根MaterialApp/CupertinoApp上，作为后续拿上下文的统一入口：

// 全局作用域定义，不要写在某个页面类内部
final GlobalKey<NavigatorState> rootNavKey = GlobalKey<NavigatorState>();

// App入口绑定Key
class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      navigatorKey: rootNavKey,
      // 其余主题、初始路由、路由表配置保持原有逻辑即可
    );
  }
}

2. 全局拦截Deep Link事件 #

不要在单个页面内注册Deep Link监听，在App根生命周期内统一注册监听，逻辑完全不依赖页面传入的context：

// App启动时初始化调用一次即可
void initDeepLinkListener() {
  // 替换成项目实际使用的Deep Link监听逻辑，uni_links、app_links等通用库都适配
  uriLinkStream.listen((Uri? link) {
    if (link == null) return;
    _triggerBottomSheetByLink(link);
  }, onError: (err) {
    // 按需处理link解析错误
  });

  // 兼容冷启动场景下收到的Deep Link
  getInitialUri().then((Uri? initialLink) {
    if (initialLink == null) return;
    _triggerBottomSheetByLink(initialLink);
  });
}

3. 统一弹窗触发逻辑 #

解析到匹配唤起Bottom Sheet的Link规则时，直接通过全局导航Key获取可用上下文，不需要任何页面传参：

void _triggerBottomSheetByLink(Uri link) async {
  // 匹配自定义Deep Link规则，示例规则为 myapp://showCustomSheet
  if (link.path != '/showCustomSheet') return;

  // 等待根路由首帧渲染完成，避免冷启动时context未就绪报错
  await WidgetsBinding.instance.waitUntilFirstFrameRasterized;
  final globalContext = rootNavKey.currentContext;
  if (globalContext == null || !globalContext.mounted) return;

  // 正常唤起Bottom Sheet即可
  showModalBottomSheet(
    context: globalContext,
    isScrollControlled: true,
    builder: (context) {
      // 自定义Bottom Sheet内容组件
      return const SizedBox(
        height: 400,
        child: Center(child: Text('Deep Link唤起的弹窗')),
      );
    },
  );
}

注意事项 #

• 全局导航Key必须绑定到最顶层的根Navigator，不要绑定嵌套路由的Navigator，否则会出现弹窗层级错误、context找不到的问题
• 冷启动场景必须等待首帧渲染完成再触发弹窗，不要拿到Link立刻执行show逻辑
• 如果你使用GetX等自带全局上下文能力的框架，可以直接用框架提供的全局context替代自定义的rootNavKey获取上下文，逻辑一致
• 如果需要在弹窗里读取Link携带的参数，直接从解析的Uri对象里取query参数传入即可，不需要走路由传参

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