go_router如何实现重复push同一个路由页面？

触发assert(!keyReservation.contains(key));报错的核心逻辑很明确：go_router默认会基于路由路径生成页面Key，同一路径生成的Key完全相同，而Flutter Navigator强制要求导航栈内所有页面的Key全局唯一，重复push同一路径时就会触发断言拦截。

以下三个方案都能实现重复push同页面的需求，按改造成本从低到高排序：

• 动态拼接唯一查询参数
  这是成本最低的改法，不需要调整全局路由配置，仅修改跳转逻辑即可：push路径时追加一个每次生成值都不重复的查询参数，go_router会将带不同查询参数的同路径识别为独立路由条目，自动生成不重复的页面Key。
  原跳转代码：

  onPressed: () {
    context.push('/a');
  },
  

  修改后：

  onPressed: () {
    // 用时间戳、自增ID、UUID这类全局唯一值做参数即可
    context.push('/a?rid=${DateTime.now().microsecondsSinceEpoch}');
  },
  

  原有GoRoute的配置不需要做任何修改，go_router匹配路由时会自动忽略未在路由路径中定义的查询参数，页面逻辑如果不需要用到这个唯一标识，完全可以忽略，不影响原有业务逻辑。
• 全局自定义页面Key生成规则
  如果你用的是go_router 10.0.0及以上版本，框架已经暴露了pageKeyBuilder配置项，可以全局统一重写页面Key的生成逻辑，不需要修改任何一处跳转代码。
  路由初始化配置修改示例：

  final router = GoRouter(
    initialLocation: '/a',
    // 自定义Key生成规则，保证每个入栈路由的Key唯一
    pageKeyBuilder: (RouteMatch match) {
      return ValueKey(
        '${match.fullPath}_${DateTime.now().microsecondsSinceEpoch}_${match.hashCode}',
      );
    },
    routes: [
      // 原有路由配置保持不变即可
      GoRoute(
        path: '/a',
        builder: (_, __) => const MyWidget(path: '/a'),
      ),
      GoRoute(
        path: '/b',
        builder: (_, __) => const MyWidget(path: '/b'),
      ),
    ],
  );
  

  这个方案适配性最好，不管业务代码里有多少处重复push同路径的逻辑，都能自动兼容。
• 基于ShellRoute拆分独立导航栈
  如果你要实现的是类似Twitter那种多Tab各自维护独立导航栈的交互，本质上不应该把所有页面都塞到根导航栈里，可以通过ShellRoute给每个业务模块配置独立的子Navigator，从架构层面避免同栈内重复Key的问题。这个方案改造成本最高，仅适合整体架构重构时选用，单纯解决重复push同页的问题不需要用。

• 不要尝试给GoRoute手动设置固定Key，固定Key在重复入栈时依然会触发Key重复的断言，必须保证每个入栈的页面实例对应的Key全局唯一。
• 采用查询参数方案时，不要把唯一参数提前写死在GoRoute的path定义里，仅在push跳转时动态拼接即可，否则会导致路由匹配失败。

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