Flutter使用WillPopScope禁用iOS左滑返回手势该如何恢复

本质原因：Flutter 旧版WillPopScope组件会重写路由的返回判定逻辑，直接屏蔽了iOS平台Cupertino路由自带的边侧滑动返回手势，且原生左滑操作不会触发onWillPop回调，才会出现对应的兼容问题。 #

方案1：使用官方替代组件PopScope（推荐，Flutter 3.16+ 适用） #

Flutter 3.16版本之后官方推出了PopScope组件，专门解决WillPopScope的手势兼容问题，默认不会屏蔽iOS左滑返回，且左滑操作会正常触发拦截回调，全平台通用。
代码示例：

PopScope(
  // canPop设为false时会拦截所有返回操作，设为true时直接放行不触发回调
  canPop: false,
  onPopInvoked: (bool didPop) async {
    // didPop为true表示系统已经执行了返回操作，无需额外处理
    if (didPop) return;
    // 此处填写你原来在onWillPop中的自定义逻辑，比如二次退出确认、未保存内容提示等
    bool allowLeave = await showConfirmDialog();
    if (allowLeave && context.mounted) {
      Navigator.of(context).pop();
    }
  },
  child: // 你的页面Widget
)

方案2：低版本Flutter兼容方案（3.16以下适用） #

如果项目暂时无法升级Flutter版本，可以自定义跨平台兼容的返回拦截组件：

import 'dart:io';
import 'package:flutter/material.dart';

class IosCompatibleWillPopScope extends StatelessWidget {
  final Widget child;
  final Future<bool> Function() onWillPop;

  const IosCompatibleWillPopScope({
    super.key,
    required this.child,
    required this.onWillPop,
  });

  @override
  Widget build(BuildContext context) {
    // iOS端监听左滑手势触发拦截逻辑
    if (Platform.isIOS) {
      return GestureDetector(
        onHorizontalDragEnd: (dragDetail) async {
          // 左滑速度超过阈值判定为返回操作，可根据需求调整阈值
          if (dragDetail.primaryVelocity! > 400) {
            bool canPop = await onWillPop();
            if (canPop && context.mounted) {
              Navigator.of(context).pop();
            }
          }
        },
        child: child,
      );
    }
    // Android端直接沿用原WillPopScope逻辑
    return WillPopScope(
      onWillPop: onWillPop,
      child: child,
    );
  }
}

使用时直接把页面原有的WillPopScope替换为IosCompatibleWillPopScope即可，原有拦截逻辑不需要修改。 #

注意事项：

1. 优先使用官方PopScope方案，稳定性和兼容性远高于自定义实现
2. 不要在同一页面同时使用WillPopScope和PopScope，避免逻辑冲突
3. 若页面使用的是Cupertino风格路由，无需额外配置即可适配左滑返回逻辑

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