Flutter CarouselSlider功能正常但报渲染库断言错误求助

问题描述 #

实现的CarouselSlider功能正常，但调试控制台持续抛出渲染库断言错误：

════════ Exception caught by rendering library
═════════════════════════════════
'package:flutter/src/rendering/sliver_fixed_extent_list.dart': Failed assertion: line 338 pos 12: 'firstIndex == 0 || childScrollOffset(firstChild!)! - scrollOffset <= precisionErrorTolerance': is not true.

组件代码如下：

Column(
  children: [
    if (state.bumperBountyData.isNotEmpty)
      CarouselSlider(
        items: state.bumperBountyData.map((e) {
          return Container(
            height: 200,
            color: Colors.red,
          );
        }).toList(),
        options: CarouselOptions(
          enableInfiniteScroll: state.bumperBountyData.length > 1,
          viewportFraction: 0.85,
          onPageChanged: (index, reason) {
            state.bumperBountyCurrentIndex = index;
            state.update([
              ProductBySectionController.bumperBountyListUpdate
            ]);
          },
          aspectRatio: 1.3,
          pauseAutoPlayOnTouch: true,
          enlargeCenterPage: false,
          disableCenter: false,
          padEnds: !(state.bumperBountyData.length > 1),
          autoPlay: state.bumperBountyData.length > 1,
        ),
      ),
  ],
),

可能原因 #

1. 状态更新与内部滚动逻辑冲突：onPageChanged中每次切换页面都强制更新状态，导致CarouselSlider频繁重建，干扰内部Sliver滚动容器的位置计算。
2. padEnds参数设置不合理：当item数量>1时padEnds设为false，结合viewportFraction:0.85的非全屏视图，可能导致滚动偏移计算超出精度容忍范围。
3. 高度约束重复冲突：同时设置Container固定高度200和CarouselOptions的aspectRatio:1.3，双重高度规则引发布局计算异常。

解决办法 #

1. 优化状态更新逻辑 #

仅当索引实际变化时触发状态更新，减少不必要的组件重建：

onPageChanged: (index, reason) {
  if (state.bumperBountyCurrentIndex != index) {
    state.bumperBountyCurrentIndex = index;
    state.update([ProductBySectionController.bumperBountyListUpdate]);
  }
},

2. 调整padEnds参数 #

将padEnds固定设为true，适配非全屏视图的滚动计算：

padEnds: true, // 替代原条件判断逻辑

3. 统一高度约束 #

移除重复的高度设置，二选一即可：

• 去掉Container的height，由aspectRatio控制高度：

return Container(
  color: Colors.red,
);

• 或删除CarouselOptions中的aspectRatio，保留Container的固定高度：

// 直接删除aspectRatio参数，或设为null
aspectRatio: null,

4. 更新依赖包版本 #

检查carousel_slider包版本，升级到最新稳定版，部分旧版本存在类似滚动计算的bug。

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