NestedScrollView搭配Nested Navigator时滚动失效如何解决？

失效原因 #

NestedScrollView的联动滚动依赖body部分的滚动组件绑定其内部自动注入的PrimaryScrollController，替换为嵌套导航后，子路由页面的滚动组件默认没有绑定该控制器，导致滚动事件无法透传给外层SliverAppBar，联动失效。

可行修复方案 #

方案1：使用系统默认PrimaryScrollController（最简便） #

嵌套导航下的所有子页面滚动组件（ListView/GridView等）统一做如下配置：

• 设置primary: true
• 不要单独指定自定义controller
• 禁用shrinkWrap（保持默认false即可）
  该方案下滚动组件会自动绑定上层NestedScrollView注入的PrimaryScrollController，直接恢复联动效果。

示例代码（子列表页面）：

class GalleryGrid extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return ListView(
      // 核心配置
      primary: true,
      shrinkWrap: false,
      // 其余原有配置
      children: [...],
    );
  }
}

方案2：手动获取内部滚动控制器（适用于需要自定义滚动逻辑的场景） #

如果子页面必须自定义滚动逻辑、要绑定自定义controller，可通过NestedScrollView.innerControllerOf(context)获取外层NestedScrollView分配给body的内部控制器，绑定到子页面的滚动组件上即可。

示例代码：

class AnotherListView extends StatefulWidget {
  @override
  State<AnotherListView> createState() => _AnotherListViewState();
}

class _AnotherListViewState extends State<AnotherListView> {
  ScrollController? _scrollController;

  @override
  void didChangeDependencies() {
    super.didChangeDependencies();
    // 获取外层NestedScrollView的内部控制器
    _scrollController = NestedScrollView.innerControllerOf(context);
  }

  @override
  Widget build(BuildContext context) {
    return ListView(
      controller: _scrollController,
      // 其余原有配置
      children: [...],
    );
  }
}

注意事项 #

• 不要在子页面的滚动组件外层额外包裹SingleChildScrollView/Scrollbar等自带滚动控制器的组件，会拦截滚动事件
• 如果使用第三方路由框架（如GoRouter），需确保嵌套路由的父节点是NestedScrollView的body，不要把NestedScrollView放在路由子树中，避免上下文隔离导致无法获取滚动控制器
• 所有子页面的滚动组件同时只能有一个处于激活状态，避免多个滚动组件竞争同一个控制器

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