Flutter如何阻止NotificationListener监听子组件PageView的滚动通知

问题原因 #

滚动通知在Flutter中默认会沿组件树向上冒泡，嵌套在CustomScrollView内部的PageView自身滚动时发出的通知，也会被外层的NotificationListener捕获，导致像素值被错误更新。

解决方案 #

方案1：拦截PageView的滚动通知（最简单） #

在PageView外层包裹一层NotificationListener，直接消费掉它发出的所有滚动通知，阻止通知向上冒泡到外层监听器。
修改你的代码中PageView对应的SliverToBoxAdapter部分即可：

SliverToBoxAdapter(
  child: NotificationListener<ScrollNotification>(
    onNotification: (_) => true, // 返回true表示当前通知已被消费，不会继续向上传递
    child: pageView(),
  ),
),

方案2：外层监听器过滤通知来源 #

如果你需要保留PageView的通知冒泡逻辑，仅在外层做过滤，可以通过绑定GlobalKey的方式，只处理CustomScrollView发出的通知：

1. 先为CustomScrollView定义一个全局Key：

final GlobalKey _customScrollKey = GlobalKey();

2. 给CustomScrollView绑定该Key：

CustomScrollView(
  key: _customScrollKey,
  // 原有其余属性不变
)

3. 修改外层NotificationListener的回调逻辑，仅处理来源为CustomScrollView的通知：

onNotification: (ScrollNotification scroll) {
  if (scroll.context?.widget.key == _customScrollKey) {
    pixelsScrolled = scroll.metrics.pixels.toInt().toString();
    setState(() {});
  }
  // 根据业务需求决定返回值：返回true表示消费通知，返回false表示通知继续向上传递
  return true;
},

补充：如果两个滚动组件方向不同可以用更简单的判断 #

如果你的CustomScrollView是垂直滚动、PageView是水平滚动，可以直接通过滚动方向过滤，不需要额外加Key：

onNotification: (ScrollNotification scroll) {
  // 仅处理垂直方向的滚动通知（即CustomScrollView的滚动）
  if (scroll.metrics.axis == Axis.vertical) {
    pixelsScrolled = scroll.metrics.pixels.toInt().toString();
    setState(() {});
  }
  return true;
},

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