Flutter嵌套ListView滚动到内层底部后无法滚动外层列表

Flutter同方向嵌套可滚动组件的手势分发逻辑中，内层滚动组件会优先消费滑动事件。当前给内层ListView设置的ClampingScrollPhysics，在列表滚动到自身上下边界后，会直接拦截剩余滑动手势，不会将事件传递给外层父列表，就会出现内层滚到底后无法继续滑动查看外层后续内容的问题。

方案1：自定义滚动物理规则（最小改动，适配现有代码结构） #

只需要新增一个支持边界手势透传的ScrollPhysics，替换内层ListView原有的physics即可，不需要改动现有布局结构。

1. 先定义自定义滚动物理类：

class NestedClampingScrollPhysics extends ClampingScrollPhysics {
  const NestedClampingScrollPhysics({ScrollPhysics? parent}) : super(parent: parent);

  @override
  NestedClampingScrollPhysics applyTo(ScrollPhysics? ancestor) {
    return NestedClampingScrollPhysics(parent: buildParent(ancestor));
  }

  @override
  double applyBoundaryConditions(ScrollMetrics position, double value) {
    // 滚动到顶部/底部边界时，不拦截剩余滑动偏移，透传给父级滚动组件
    if (value < position.pixels && position.pixels <= position.minScrollExtent) {
      return 0;
    }
    if (value > position.pixels && position.pixels >= position.maxScrollExtent) {
      return 0;
    }
    return super.applyBoundaryConditions(position, value);
  }
}

2. 替换内层ListView的physics属性：

ListView(
  physics: const NestedClampingScrollPhysics(),
  // 其余原有属性和子项保持不变
  children: [/* 原有内层列表项 */]
)

改完之后，在内层区域滑动时会优先滚动内层列表，内层滚动到顶部/底部后，继续滑动就会自动带动外层列表滚动。

方案2：使用官方NestedScrollView组件（推荐，官方规范实现） #

NestedScrollView是Flutter官方专门为同方向嵌套滚动场景设计的组件，会自动协调内外层滚动偏移，不存在手势冲突问题。可以将外层原有的ListView替换为NestedScrollView，把外层固定的列表项转换为Sliver组件放入头部构建器，内层列表和外层末尾项放入滚动主体中。
核心代码示例：

class MyWidget extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return NestedScrollView(
      headerSliverBuilder: (context, innerBoxIsScrolled) {
        // 外层开头的列表项放在这里
        return [
          SliverToBoxAdapter(
            child: Text(
              'Hello, World!',
              style: Theme.of(context).textTheme.headline4,
            ),
          ),
          SliverToBoxAdapter(
            child: Text(
              'Hello, World!',
              style: Theme.of(context).textTheme.headline4,
            ),
          ),
        ];
      },
      body: SingleChildScrollView(
        child: Column(
          mainAxisSize: MainAxisSize.min,
          children: [
            SizedBox(
              width: MediaQuery.of(context).size.width,
              height: MediaQuery.of(context).size.height,
              child: ListView(
                physics: const ClampingScrollPhysics(),
                children: [
                  // 原有内层列表的所有子项保持不变
                ],
              ),
            ),
            // 外层末尾的列表项放在这里
            Text(
              'Hello, World!',
              style: Theme.of(context).textTheme.headline4,
            ),
            Text(
              'Hello, World!',
              style: Theme.of(context).textTheme.headline4,
            ),
          ],
        ),
      ),
    );
  }
}

• 不要给内层嵌套的ListView手动设置primary: true，否则会强制抢占主滚动控制器，破坏手势传递逻辑，默认情况下嵌套子列表会自动将primary设为false，无需额外配置。
• 如果内层列表的子项高度不固定，优先使用方案2的NestedScrollView实现，滚动性能更优。

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