为什么WillPopScope总是禁用侧滑返回，如何实现条件控制返回功能？

你遇到的是Flutter旧版WillPopScope组件的已知问题：iOS侧滑返回手势的拦截逻辑不会预先读取onWillPop的异步返回值判断是否放行，只要页面挂载了WillPopScope组件，就会默认拦截所有侧滑返回手势，和你onWillPop的返回结果无关。

方案1：使用新版PopScope组件（推荐） #

Flutter 3.10及以上版本已经废弃了WillPopScope，推出了替代组件PopScope，完全解决了侧滑返回手势的动态控制问题，直接按照你的需求传状态即可：

PopScope(
  // 直接传入你的控制变量即可，框架会自动判断是否允许手势返回和系统返回
  canPop: widget._canSwipeBack,
  // 可选配置，可监听pop事件的触发结果
  onPopInvoked: (didPop) {
    // 页面成功返回后可以在这里处理后续逻辑
  },
  child: <some child>
)

不需要根据状态动态增删组件，直接修改_canSwipeBack的值即可实时控制返回权限。

方案2：低版本Flutter兼容方案 #

如果你使用的Flutter版本低于3.10，无法使用PopScope组件，可以通过自定义Cupertino路由的方式实现：

1. 首先自定义路由类，重写侧滑手势判断逻辑

class DynamicPopCupertinoRoute<T> extends CupertinoPageRoute<T> {
  DynamicPopCupertinoRoute({
    required super.builder,
    super.settings,
    required this.canPopCallback,
  });

  // 外部传入的是否允许返回的判断回调
  final bool Function() canPopCallback;

  @override
  bool get hasScopedWillPopCallback {
    // 只有不允许返回的时候，才告知框架存在拦截回调，阻止侧滑手势触发
    return !canPopCallback();
  }
}

2. 跳转页面时使用自定义路由，页面内还是保留原有的WillPopScope配置即可：

// 跳转逻辑示例
Navigator.push(
  context,
  DynamicPopCupertinoRoute(
    builder: (context) => YourPage(),
    // 传入页面的状态判断回调
    canPopCallback: () => _canSwipeBack,
  ),
);

// 页面内的WillPopScope配置不变
WillPopScope(
  onWillPop: () async => _canSwipeBack,
  child: <some child>,
)

修改_canSwipeBack的值即可动态控制是否允许侧滑返回，不需要动态增删WillPopScope组件。

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