Flutter如何在Widget树可用时可靠拦截Pop？能否拦截Push？

一、现有实现的问题 #

你当前的代码存在几个关键问题：

• 通过result == null判断系统Pop不可靠，手动调用Navigator.pop(null)也会触发该逻辑，无法精准区分系统返回和手动Pop
• 虽然异步函数_save()当前能运行，但依赖result的判断逻辑有漏洞，且未校验Widget是否仍挂载
• 设置canPop: false会直接阻断所有Pop操作，包括Navigator.popUntil()这类需要正常执行的场景，导致功能异常

二、标准可靠的Pop拦截实现 #

Flutter 3.12+推荐使用PopScope，以下是正确的实现方式：

方案1：动态控制canPop+ 拦截未允许的Pop #

return PopScope(
  // 根据业务状态动态决定是否允许直接Pop（比如无未保存修改时允许）
  canPop: !_hasUnsavedChanges,
  onPopInvokedWithResult: (bool didPop, Object? result) async {
    if (!didPop) {
      // didPop为false表示系统尝试Pop但被canPop阻止，此时Widget树仍可用
      await _save();
      // 校验Widget仍挂载后再执行Pop
      if (mounted) {
        Navigator.of(context).pop(true);
      }
    }
  },
  child: YourChildWidget(),
);

• 核心：通过didPop判断是否进入拦截逻辑，避免依赖不可靠的result值
• 动态canPop：仅在需要拦截时阻止默认Pop，不影响popUntil()等正常操作
• mounted校验：确保执行Navigator.pop时Widget仍处于活跃状态，避免异常

方案2：精准区分系统Pop和手动Pop #

如果需要严格区分系统返回键和手动Pop，可通过自定义标记实现：

// 手动Pop时传入专属标记
Navigator.of(context).pop('manual_triggered');

// PopScope中处理逻辑
PopScope(
  canPop: false,
  onPopInvokedWithResult: (bool didPop, Object? result) async {
    if (result != 'manual_triggered') {
      // 非手动触发的Pop（系统返回或未传标记的Pop），执行拦截
      await _save();
      if (mounted) {
        Navigator.of(context).pop(true);
      }
    }
  },
  child: YourChildWidget(),
);

这种方式比判断result == null更精准，完全由业务逻辑控制标记。

三、拦截Push操作的方法 #

Flutter没有原生Widget直接支持Push拦截，但可以通过自定义NavigatorObserver实现：

class PushInterceptor extends NavigatorObserver {
  @override
  void didPush(Route<dynamic> route, Route<dynamic>? previousRoute) {
    super.didPush(route, previousRoute);
    // 自定义判断逻辑，比如检查当前页面是否允许跳转
    bool canPush = _checkPermission(route);
    if (!canPush) {
      // 拦截：移除刚Push的路由
      navigator?.pop();
    }
  }

  bool _checkPermission(Route route) {
    // 示例：判断路由是否为目标页面，或检查当前页面状态
    return true;
  }
}

// 在MaterialApp中注册Observer
MaterialApp(
  navigatorObservers: [PushInterceptor()],
  home: HomePage(),
);

• 原理：通过监听didPush事件，在路由完成Push后判断是否拦截，若不允许则手动Pop该路由
• 若需要在Push前拦截，可封装全局的Push工具类，统一处理跳转逻辑，比如：

class NavigatorUtils {
  static Future<T?> push<T>(BuildContext context, Route<T> route) {
    if (_canPush()) {
      return Navigator.push(context, route);
    } else {
      // 拦截逻辑，比如提示用户
      return Future.value(null);
    }
  }

  static bool _canPush() {
    // 自定义判断规则
    return true;
  }
}

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