Flutter GoRouter：同路由带参跳转刷新及动态嵌套路由问题

一、同路由不同参数触发页面重载（类似pushReplacement） #

问题原因 #

GoRouter 对于路径相同的路由，默认不会重建 StatefulWidget 实例，仅会更新传入的参数。因此 initState 不会再次触发（该方法仅在 widget 首次插入 widget 树时执行），即使设置 maintainState: false，也仅控制页面状态是否保留，不影响实例重建逻辑。

解决方案 #

1. 迁移初始化逻辑到 didUpdateWidget

将原本在 initState 中初始化 cubit 的逻辑，移至 didUpdateWidget 方法，通过对比新旧参数判断是否需要重新初始化：

class MyPage extends StatefulWidget {
  final String param;
  const MyPage({super.key, required this.param});

  @override
  State<MyPage> createState() => _MyPageState();
}

class _MyPageState extends State<MyPage> {
  @override
  void initState() {
    super.initState();
    // 首次初始化
    context.read<MyCubit>().initWithParam(widget.param);
  }

  @override
  void didUpdateWidget(covariant MyPage oldWidget) {
    super.didUpdateWidget(oldWidget);
    // 参数变化时重新初始化
    if (widget.param != oldWidget.param) {
      context.read<MyCubit>().initWithParam(widget.param);
    }
  }

  @override
  Widget build(BuildContext context) {
    // 页面构建逻辑
    return ...;
  }
}

2. 给页面添加参数关联的唯一 Key

在路由的 pageBuilder 中，为 MaterialPage 设置基于参数的 ValueKey，当参数变化时，Flutter 会识别为新的 widget 实例，从而触发重建并执行 initState：

GoRoute(
  path: '/my_page',
  pageBuilder: (context, state) {
    final param = state.queryParams['param'];
    return MaterialPage(
      key: ValueKey(param), // 用参数作为唯一标识
      maintainState: false,
      child: MyPage(param: param!),
    );
  },
)

之后调用 context.go('/my_page?param=$differentId') 时，页面会完全重建，initState 正常触发。

二、保留导航栈，无限次进入同一页面 #

直接使用 context.push() 即可实现该需求，无需手动维护路由列表：

• 每次调用 context.push('/my_page?param=$newId')，GoRouter 会在当前导航栈顶新增一个 MyPage 实例，保留之前的页面状态。
• 新页面的 initState 会正常触发，因为是全新的 widget 实例插入树中。
• 返回时可通过系统返回键或 context.pop() 回到上一个页面，完整保留导航栈历史。

总结 #

• 若需替换当前路由并重载页面：选择迁移初始化逻辑到 didUpdateWidget，或给页面添加参数关联的 ValueKey。
• 若需保留导航栈多次进入同一页面：直接使用 context.push() 即可满足需求。

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