Flutter持久化导航返回原路由报Duplicate GlobalKey错误如何解决

你遇到的Duplicate GlobalKey detected in widget tree错误，核心原因是你把同一个MainPage Widget实例存在静态变量中反复插入组件树。MainPage内的NavigatorTab组件绑定了全局唯一的GlobalKey，Flutter机制要求同一个GlobalKey同一时间只能被组件树中的一个Widget持有，重复插入同一个带GlobalKey的Widget实例就会触发该断言。
同时你自定义的返回逻辑完全违背Flutter路由栈设计，才会出现最初按返回键直接退出应用的问题。

你用rootNavigator: true跳转播放器页的逻辑本身是正确的——要覆盖底部导航栏展示全屏页面，确实需要把路由推到根Navigator栈上。返回直接退出应用的原因是：你的homepage、episodepage是挂载在底部导航栏对应的嵌套Navigator栈中，而非根Navigator栈。在播放器页直接调用根Navigator的pop操作时，根Navigator栈下只剩应用根节点，自然会直接关闭应用。

不需要存储静态Widget实例，按嵌套路由规范实现即可，步骤如下：

• 搭建双Navigator结构
  为持久化底部导航栏配置嵌套Navigator：底部导航栏容器作为根Navigator的首页，每个Tab对应独立的嵌套Navigator，配置专属navigatorKey。Tab内部的页面跳转（homepage >> episodepage）全部通过对应Tab的嵌套Navigator执行push操作，底部导航栏通过Offstage组件控制不同Tab页面的显隐，实现切换Tab不丢页面状态的持久化效果。
• 统一路由跳转规则
  • 所有需要隐藏底部导航栏的全屏页面（如视频播放页），跳转时统一使用Navigator.of(context, rootNavigator: true).push(...)将路由推到根Navigator栈，保持你原来的跳转写法即可
  • 视频播放页不需要自定义复杂的返回逻辑，移除你写的WillPopScope中手动pushReplacement主页的代码，直接调用根Navigator的pop方法即可：

// 播放器页返回逻辑
Navigator.of(context, rootNavigator: true).pop();

执行pop后，根路由栈上的播放器页被移除，下方露出的就是之前停留在episodepage的嵌套导航页面，会直接回到剧集页，不会出现直接退出应用的问题。

如果暂时不想重构嵌套路由结构，仅消除GlobalKey报错，不要存储Widget实例，改为存储页面构建函数，每次跳转时生成新的Widget实例即可：

class C {
  static WidgetBuilder? mainPageBuilder;
}

// MyApp初始化时存入构建函数，而非Widget实例
@override
Widget build(BuildContext context) {
  C.mainPageBuilder = (context) => MyHomePage(title: 'Flutter Demo Home Page');
  return MaterialApp(
    debugShowCheckedModeBanner: false,
    themeMode: ThemeMode.light,
    title: 'Flutter Demo',
    theme: ThemeData(primarySwatch: Colors.blue),
    home: C.mainPageBuilder!(context),
  );
}

// 播放器页返回逻辑
if (C.mainPageBuilder != null) {
  Navigator.of(context, rootNavigator: true).pushReplacement(
    MaterialPageRoute(builder: C.mainPageBuilder!)
  );
}

该方案仅能消除GlobalKey报错，本质不符合路由栈设计，返回时会直接回到首页，丢失episodepage的页面状态和跳转参数，用户体验差，仅适合临时应急使用。

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