如何在Flutter中使用go_router退出初始路由并关闭应用？

问题背景 #

使用go_router作为Flutter应用导航方案，初始路由为/home对应HomePage页面。页面内的关闭按钮期望实现类似原生Navigator.of(context).pop()的效果——关闭作为路由栈首个页面的HomePage并退出应用，但调用context.pop()时抛出错误：

======== Exception caught by gesture ===============================================================
The following GoError was thrown while handling a gesture:
There is nothing to pop

When the exception was thrown, this was the stack:
#0 GoRouterDelegate.pop (package:go_router/src/delegate.dart:94:5)
#1 GoRouter.pop (package:go_router/src/router.dart:492:20)
#2 GoRouterHelper.pop (package:flutter/src/navigation/extensions.dart:71:65)
#3 HomeView.build. (package:navigation/home_view.dart:25:33)
#4 _InkResponseState.handleTap (package:flutter/src/material/ink_well.dart:1096:21)
#5 GestureRecognizer.invokeCallback (package:flutter/src/gestures/recognizer.dart:253:24)
#6 TapGestureRecognizer.handleTapUp (package:flutter/src/gestures/tap.dart:627:11)
#7 BaseTapGestureRecognizer._checkUp (package:flutter/src/gestures/tap.dart:306:5)
#8 BaseTapGestureRecognizer.acceptGesture (package:flutter/src/gestures/tap.dart:276:7)
#9 GestureArenaManager.sweep (package:flutter/src/gestures/arena.dart:163:27)
#10 GestureBinding.handleEvent (package:flutter/src/gestures/binding.dart:464:20)
#11 GestureBinding.dispatchEvent (package:flutter/src/gestures/binding.dart:440:22)
#12 RendererBinding.dispatchEvent (package:flutter/src/rendering/binding.dart:336:11)
#13 GestureBinding._handlePointerEventImmediately (package:flutter/src/gestures/binding.dart:395:7)
#14 GestureBinding.handlePointerEvent (package:flutter/src/gestures/binding.dart:357:5)
#15 GestureBinding._flushPointerEventQueue (package:flutter/src/gestures/binding.dart:314:7)
#16 GestureBinding._handlePointerDataPacket (package:flutter/src/gestures/binding.dart:295:7)
#17 _invoke1 (dart:ui/hooks.dart:164:13)
#18 PlatformDispatcher._dispatchPointerDataPacket (dart:ui/platform_dispatcher.dart:361:7)
#19 _dispatchPointerDataPacket (dart:ui/hooks.dart:91:31)
Handler: "onTap"
Recognizer: TapGestureRecognizer#94750
debugOwner: GestureDetector
state: ready
won arena
finalPosition: Offset(165.4, 119.6)
finalLocalPosition: Offset(31.6, 25.6)
button: 1
sent tap down #

解决方案 #

方案1：直接调用系统级退出 #

go_router的pop()仅能处理路由栈内页面弹出，根路由时无页面可弹，此时直接调用系统导航方法退出应用：

import 'dart:io';

// 按钮点击逻辑
onPressed: () {
  SystemNavigator.pop();
}

该方法适配Android、iOS及桌面平台，直接通知系统终止应用进程。

方案2：判断路由状态后分支处理 #

若需同时支持页面弹出和应用退出，可先检查路由栈状态：

onPressed: () {
  final router = GoRouter.of(context);
  // 检查是否有可弹出的页面
  if (router.routerDelegate.navigatorKey.currentState?.canPop() ?? false) {
    router.pop();
  } else {
    SystemNavigator.pop();
  }
}

也可直接通过当前路由路径判断：

onPressed: () {
  final router = GoRouter.of(context);
  if (router.location == '/home') {
    SystemNavigator.pop();
  } else {
    router.pop();
  }
}

方案3：全局配置onPopPage回调 #

初始化GoRouter时，通过onPopPage统一拦截根路由的弹出操作：

final GoRouter router = GoRouter(
  initialLocation: '/home',
  routes: [
    GoRoute(
      path: '/home',
      builder: (context, state) => const HomePage(),
    ),
    // 其他路由定义
  ],
  onPopPage: (route, result) {
    // 匹配根路由时退出应用
    if (route.settings.name == '/home') {
      SystemNavigator.pop();
      return false; // 阻止go_router默认的pop行为
    }
    return route.didPop(result);
  },
);

此配置下，所有页面调用context.pop()时都会经过该回调，根路由场景自动触发应用退出。

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