Flutter中NestedScrollView滚动随机报result is not true错误且SliverAppBar无法折叠

该报错与SliverAppBar折叠异常的核心原因是：NestedScrollView与内部嵌套的SingleChildScrollView产生滚动冲突。NestedScrollView本身已经会统一管理头部Sliver和body区域的滚动行为，额外嵌套独立可滚动组件会导致两个滚动控制器手势竞争、滚动偏移计算异常，最终触发源码中的断言错误。

修复方案 #

• 方案1（最推荐）：移除NestedScrollViewbody属性内的SingleChildScrollView，替换为CustomScrollView搭配Sliver组件承载内容：

Scaffold(
  body: NestedScrollView(
    headerSliverBuilder: (context, innerBoxIsScrolled) => [
      SliverAppBar(
        pinned: true, // 根据需求配置折叠属性，避免无配置导致折叠失效
        floating: false,
        expandedHeight: 200,
        flexibleSpace: FlexibleSpaceBar(
          title: Text("页面标题"),
        ),
      )
    ],
    body: CustomScrollView(
      slivers: [
        // 原SingleChildScrollView内的单个组件用SliverToBoxAdapter包裹
        SliverToBoxAdapter(
          child: Container(height: 300, color: Colors.blue),
        ),
        // 列表类内容用SliverList承载
        SliverList(
          delegate: SliverChildBuilderDelegate(
            (context, index) => ListTile(title: Text("列表项$index")),
            childCount: 30,
          ),
        )
      ],
    ),
  )
);

• 方案2（适配历史代码）：如果修改原有结构成本较高，保留SingleChildScrollView并添加两个配置，禁用自身滚动能力，完全交由NestedScrollView管理滚动：

NestedScrollView(
  headerSliverBuilder: ...,
  body: SingleChildScrollView(
    physics: const NeverScrollableScrollPhysics(), // 禁用自身滚动
    shrinkWrap: true, // 自适应子组件高度
    child: // 原有的全部子内容
  )
)

• 额外兼容：如果修改后仍偶现断言报错，给NestedScrollView手动指定唯一的ScrollController，统一管理滚动偏移，避免框架自动生成的控制器出现状态不一致问题。

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