Flutter使用wechat_assets_picker选单图触发RangeError索引异常求解

这个RangeError (index): Invalid value: Only valid value is 0: 1属于典型的列表索引越界错误，仅在选择1张图片时触发、选2张及以上正常的场景，对应修复方法如下：

1. 检查本地图片选择结果的拼接逻辑 #

• 排查你将选择器返回的图片资源添加到全局展示列表的代码，是否存在多余的截取、偏移操作：例如错误使用result.sublist(0, result.length - 1)，选择1张图片时result.length - 1 = 0，截取结果为空列表，后续访问索引1时就会触发越界；或者错误使用insert方法传入了超过当前列表长度的索引值。
• 修复方式：直接使用标准列表拼接方法，不要额外处理返回结果：

// 选择器返回结果非空判断后直接全量添加
imageList.addAll(selectedAssets);

2. 检查ListView的配置逻辑 #

• 排查ListView的itemCount参数是否配置错误：例如为了添加头部/添加按钮写死了itemCount: imageList.length + 1，但在itemBuilder中没有做索引判断，当列表只有1个元素时，itemCount = 2，构建索引1的item时就会越界。
• 修复方式：如果不需要额外头尾元素，直接设置itemCount: imageList.length；如果需要添加额外元素，在itemBuilder中增加索引校验：

ListView.builder(
  itemCount: imageList.length + 1,
  itemBuilder: (context, index) {
    if (index == 0) {
      // 返回头部/添加按钮组件
    } else {
      final imageItem = imageList[index - 1];
      // 返回图片展示组件
    }
  }
)

3. 增加选择结果的前置校验 #

调用图片选择器后先校验返回结果的合法性，避免空列表/长度异常的资源被加入展示列表：

final List<AssetEntity>? selectedAssets = await AssetPicker.pickAssets(context);
// 先判断返回结果是否为空、长度是否合法，再执行后续操作
if (selectedAssets == null || selectedAssets.isEmpty) return;
// 执行列表拼接+刷新UI操作
imageList.addAll(selectedAssets);
setState(() {});

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