Flutter中Go Router无返回按钮且pop报错问题求助

问题现象 #

• 使用GoRouter的go()方法跳转页面后，目标页面的AppBar不会自动显示返回按钮
• 手动添加返回按钮并调用GoRouter.of(context).pop()时，触发There is nothing to pop错误
• 将跳转代码从go()替换为push()后，返回按钮自动显示，点击pop也不再报错

原因分析 #

GoRouter的go()和push()方法核心区别在于路由栈的处理逻辑：

• go()：替换当前路由栈，会把当前页面从栈中移除后添加新页面，此时路由栈中只有新页面，没有可返回的上一页，所以调用pop()会报错，AppBar也不会自动生成返回按钮
• push()：向路由栈追加新页面，保留原页面在栈内，路由栈存在上一页，因此AppBar会自动显示返回按钮，调用pop()也能正常返回

解决方案 #

方案1：使用push()进行跳转（推荐）

这是符合常规导航逻辑的方式，GoRouter会自动管理路由栈，无需手动处理返回按钮：

// 替换原go()方法为push()
GoRouter.of(context).push(CategoryDetail.routeName);

方案2：若必须使用go()，则安全处理返回逻辑

如果业务场景需要用go()替换路由，手动添加返回按钮时，要先判断路由栈是否有可返回的页面：

AppBar(
  title: Text(TRANSLATION.record_detail),
  leading: IconButton(
    onPressed: () {
      // 先判断是否可以pop
      if (GoRouter.of(context).canPop()) {
        GoRouter.of(context).pop();
      } else {
        // 无页面可返回时，跳转到首页或其他指定页面
        GoRouter.of(context).go('/');
      }
    },
    icon: Icon(Icons.arrow_back_ios),
  ),
)

注意事项 #

• 除非有特殊业务需求，否则优先使用push()进行页面跳转，避免路由栈异常
• 任何时候调用pop()前，都建议用canPop()做判断，防止出现无页面可返回的错误

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