迭代Firebase DataSnapshot子节点时抛出RangeError问题排查

问题场景 #

当处理Firebase的DataSnapshot时，仅针对数组类型节点（Firebase自动分配连续整数键），迭代其children时会抛出RangeError (index): Invalid value: Not in inclusive range 0..6: -1异常，即使子节点实际数量为7（索引范围0-6）。尝试过for-in循环、迭代器遍历、提前判断子节点非空等写法，均无法解决该问题。

问题原因 #

Firebase SDK对数组类型的DataSnapshot有特殊逻辑：当节点被识别为数组时，其children的内部遍历依赖连续索引机制，若强行将其转为Map（把整数键转为字符串键存储），会触发内部索引越界。此外，数组类型节点的value本身是List类型，直接按Map逻辑处理会导致类型冲突。

解决方案 #

修改递归转换逻辑，区分数组和映射类型分别处理：

dynamic convertSnapshot(DataSnapshot snapshot) {
  if (!snapshot.exists) return null;

  // 判断是否为Firebase数组：所有子节点key都是非负整数字符串
  bool isArray = snapshot.children.every((child) {
    final index = int.tryParse(child.key!);
    return index != null && index >= 0;
  });

  if (isArray) {
    // 按索引排序后处理，保证数组顺序正确
    final sortedChildren = snapshot.children.toList()
      ..sort((a, b) => int.parse(a.key!).compareTo(int.parse(b.key!)));
    
    return sortedChildren.map(convertSnapshot).toList();
  } else {
    final map = <String, dynamic>{};
    for (final child in snapshot.children) {
      map[child.key!] = convertSnapshot(child);
    }
    return map;
  }
}

说明 #

1. 数组判断逻辑：通过校验所有子节点的key是否为有效非负整数，识别Firebase数组类型节点。
2. 数组处理：将子节点按索引排序后递归处理，最终转为List，避免Map转换带来的索引异常。
3. 映射处理：保持原有递归逻辑，将子节点键值对存入Map，兼容普通映射类型节点。

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