Flutter中PageView嵌套ListView：无法从第二页滑回第一页

问题原因 #

垂直PageView中的ListView会默认拦截顶部的向上滑动手势，导致父级PageView无法响应页面切换操作——即便ListView已经滚动到顶部，手势事件也不会传递给PageView。

解决方案 #

自定义一个ScrollPhysics，让ListView在滚动到顶部且用户向上滑动时，将手势控制权交还给PageView，同时保留ListView正常的滚动行为。

修改后的完整代码 #

import 'package:flutter/material.dart';

void main() {
  runApp(const MainApp());
}

// 自定义滚动物理规则，允许父组件在ListView顶部时获取滑动事件
class ParentAwareScrollPhysics extends ScrollPhysics {
  const ParentAwareScrollPhysics({super.parent});

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

  @override
  bool shouldAcceptUserOffset(ScrollMetrics position) {
    // 仅当ListView未到顶部，或用户向下滑动时，才由ListView处理滚动
    return position.pixels > position.minScrollExtent || 
           position.userScrollDirection == ScrollDirection.reverse;
  }
}

class MainApp extends StatelessWidget {
  const MainApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: PageView(
          scrollDirection: Axis.vertical,
          children: [
            // 第一页：入口页面
            Column(
              children: [
                Container(
                  height: 200,
                  width: 200,
                  color: Colors.green,
                  child: const Center(child: Text('Page 1')),
                ),
                const Spacer(),
                const Text('scroll down for history'),
              ],
            ),
            // 第二页：历史条目列表
            ListView(
              // 应用自定义滚动物理规则
              physics: const ParentAwareScrollPhysics(),
              shrinkWrap: true,
              children: List.generate(
                  100, (index) => ListTile(title: Text('Item $index'))),
            ),
          ],
        ),
      ),
    );
  }
}

代码说明 #

1. 自定义ParentAwareScrollPhysics：
   • 重写shouldAcceptUserOffset方法，判断ListView是否拦截当前滑动手势：
     • 当ListView处于顶部且用户向上滑动时，返回false，不拦截手势，让父级PageView处理页面切换；
     • 其他场景（ListView未到顶部、用户向下滑动）返回true，保持ListView正常滚动逻辑。
2. 绑定物理规则到ListView：将ListView的physics属性设置为自定义的ParentAwareScrollPhysics，即可实现预期交互。

验证效果 #

• 从第一页向下滑动，正常切换到第二页；
• 第二页的ListView可正常向下/向上滚动；
• 当ListView处于顶部时，向上滑动会触发PageView切换回第一页。

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