Flutter GestureDetector中onVerticalDragUpdate多次触发问题求助

onVerticalDragUpdate和onPanUpdate的原生设计即为滑动过程中每检测到手指位置变化就触发一次回调，只要滑动动作未结束，回调就会随位移变化持续触发，不属于BUG，和灵敏度参数设置无关。

• 方案1：改用滑动结束回调（翻页场景最推荐）
  如果你的业务逻辑只需要完成一次操作（比如翻页），直接将逻辑放到滑动结束回调中即可，该回调仅在滑动动作结束时触发1次：

GestureDetector(
  onVerticalDragEnd: (details) {
    // primaryVelocity大于0代表向下滑动的结束速度为正，判定为有效下滑
    if (details.primaryVelocity! > 0) {
      print('------Down Swipe----');
      changePage(currentPage++);
    }
  }
)

• 方案2：增加触发锁（滑动过程中仅触发一次逻辑）
  如果必须在滑动过程中触发逻辑，可以通过布尔锁控制单次滑动仅执行一次操作，滑动结束后重置锁即可：

// 组件内部定义状态变量
bool _isOperationExecuted = false;

GestureDetector(
  onVerticalDragUpdate: (details) {
    if (details.delta.dy > 0 && !_isOperationExecuted) {
      _isOperationExecuted = true;
      print('------Down Swipe----');
      changePage(currentPage++);
    }
  },
  // 滑动结束/取消时重置锁
  onVerticalDragEnd: (_) => _isOperationExecuted = false,
  onVerticalDragCancel: () => _isOperationExecuted = false,
)

• 方案3：增加滑动阈值过滤微小抖动
  如果需要避免手指微小位移、抖动导致的误触发，可以设置最小滑动阈值，累计滑动距离超过阈值后再执行逻辑：

// 组件内部定义变量
double _totalDragOffset = 0;
// 自定义有效滑动阈值，单位为逻辑像素
static const double _minValidDrag = 15;

GestureDetector(
  onVerticalDragUpdate: (details) {
    _totalDragOffset += details.delta.dy;
    if (_totalDragOffset > _minValidDrag) {
      print('------Down Swipe----');
      changePage(currentPage++);
      // 执行后重置累计值避免重复触发
      _totalDragOffset = -double.infinity;
    }
  },
  onVerticalDragEnd: (_) => _totalDragOffset = 0,
  onVerticalDragCancel: () => _totalDragOffset = 0,
)

额外提示：如果是上下翻页的业务场景，直接使用Flutter官方的PageView组件并设置scrollDirection: Axis.vertical，即可直接实现完整的滑动翻页逻辑，不需要手动处理手势冲突、重复触发等问题。

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