Flutter自定义ScrollPhysics问题：Fling后Underscroll无法正常回弹

问题根源 #

当用户执行Fling后松开手指，滚动进入**弹道模拟（Ballistic Simulation）**阶段，原代码的applyBoundaryConditions会强制将滚动位置限制在minScrollExtent - underscrollAllowance，但createBallisticSimulation只处理了“当前已处于underscroll状态”的场景，没覆盖“Fling惯性导致滚动到允许范围外”的情况，最终导致视图卡在限制位置无法回弹。

修复后的CustomScrollPhysics实现 #

调整两个核心方法，让拖拽限制和惯性回弹逻辑配合：

class CustomScrollPhysics extends ScrollPhysics {
  final double underscrollAllowance;
  final Function(ScrollMetrics position, double value, bool isUnderscrolling)? onScroll;

  CustomScrollPhysics({
    ScrollPhysics? parent,
    this.onScroll,
    required this.underscrollAllowance,
  }) : super(parent: parent);

  @override
  CustomScrollPhysics applyTo(ScrollPhysics? ancestor) {
    return CustomScrollPhysics(
      parent: buildParent(ancestor),
      underscrollAllowance: underscrollAllowance,
      onScroll: onScroll,
    );
  }

  @override
  double applyBoundaryConditions(ScrollMetrics position, double value) {
    bool isUnderscrolling = value < position.minScrollExtent;
    onScroll?.call(position, value, isUnderscrolling);

    // 仅在用户主动拖拽时限制underscroll范围（拖拽时velocity为0）
    // 惯性滚动时放开限制，交给弹道模拟处理回弹逻辑
    if (position.velocity == 0 && value < (position.minScrollExtent - underscrollAllowance)) {
      return value - (position.minScrollExtent - underscrollAllowance);
    }

    return 0.0;
  }

  @override
  Simulation? createBallisticSimulation(ScrollMetrics position, double velocity) {
    // 场景1：当前已处于underscroll状态，直接创建回弹到min的模拟
    if (position.pixels < position.minScrollExtent) {
      return ScrollSpringSimulation(
        spring,
        position.pixels,
        position.minScrollExtent,
        velocity, // 保留原始velocity，让回弹动画更自然
      );
    }

    // 场景2：预测Fling惯性会超出允许范围，提前拦截创建回弹模拟
    final double minAllowedPosition = position.minScrollExtent - underscrollAllowance;
    final Simulation? parentSimulation = super.createBallisticSimulation(position, velocity);
    
    if (parentSimulation != null) {
      // 计算模拟结束时的最终位置
      final double finalPosition = parentSimulation.x(double.infinity);
      if (finalPosition < minAllowedPosition) {
        return ScrollSpringSimulation(
          spring,
          minAllowedPosition,
          position.minScrollExtent,
          velocity * 0.5, // 衰减速度避免回弹过度
        );
      }
    }

    // 其他情况使用父类默认模拟逻辑
    return super.createBallisticSimulation(position, velocity);
  }
}

关键修复点说明 #

• applyBoundaryConditions优化：通过position.velocity == 0区分用户拖拽和惯性滚动，仅在拖拽时限制underscroll范围，避免干扰惯性阶段的自然回弹。
• createBallisticSimulation完善：
  • 保留原始velocity传入回弹模拟，解决原代码回弹生硬的问题；
  • 预测Fling惯性的最终位置，提前拦截超出允许范围的情况，确保视图总能回弹到正常位置。

额外测试建议 #

重点覆盖以下场景验证效果：

• 主动拖拽underscroll后松开
• Fling操作立即触发underscroll
• Fling后惯性滚动到underscroll范围

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