Flutter GoRouter中context.pop()触发上页重建致参数缺失报错

核心原因 #

GoRouter的builder方法会在路由被激活时（包括从子页面pop返回）重新执行，但state.extra参数不会被持久化到导航栈的路由记录中。你通过extra传递的necessaryParam，在从InnerPage2 pop回InnerPage时已经丢失，导致builder里的参数校验抛出异常。

无参数路由返回时状态看似保留，是因为Flutter的Element树会复用StatefulWidget的状态实例，但builder本身仍然会被调用——只是没有参数依赖，所以不会报错。

正确解决方案 #

1. 将必要参数放到路由路径中（推荐） #

把参数编码到路由路径里，GoRouter会自动将参数保存到路由记录中，pop返回时能正常解析：

修改路由配置：

routes: <RouteBase>[
  GoRoute(
    path: '/landing',
    builder: (context, state) => LandingPage(),
    routes: <RouteBase>[
      GoRoute(
        path: 'inner/:necessaryParam', // 路径参数
        name: 'inner',
        builder: (context, state) {
          // 从pathParameters获取参数
          final necessaryParam = state.pathParameters['necessaryParam']!;
          return InnerPage(param: necessaryParam);
        },
        routes: <RouteBase>[
          GoRoute(
            path: 'inner2',
            name: 'inner2',
            builder: (context, state) => InnerPage2(),
          ),
        ],
      ),
    ],
  ),
]

跳转InnerPage时使用路径参数：

context.pushNamed('inner', pathParameters: {
  'necessaryParam': 'your_param_value',
});

2. 使用状态管理持久化参数 #

如果参数不适合放到路径中（比如复杂对象），可以用Provider、Riverpod等状态管理工具保存参数，在builder中直接从状态管理获取，不再依赖state.extra：

// 用Riverpod示例
final necessaryParamProvider = StateProvider<String>((ref) => '');

// 跳转InnerPage时先更新状态
context.read(necessaryParamProvider.notifier).state = 'your_param_value';
context.pushNamed('inner');

// InnerPage的builder
builder: (context, state) {
  final necessaryParam = context.read(necessaryParamProvider);
  return InnerPage(param: necessaryParam);
},

3. 避免使用extra传递必要参数 #

extra设计用于一次性传递临时数据，不会被存储到路由栈中，因此不适合传递页面必须的参数。

关于导航栈的疑问 #

导航栈确实保存了路由的状态，但GoRouter的声明式设计决定了每次路由激活时都会调用builder。StatefulWidget的状态会被Flutter的Element树保留（只要路由没被弹出栈），但如果你的页面构建依赖于未持久化的参数（比如extra），就会导致重建时参数丢失。

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