Flutter展示嵌套JSON数组遇RangeError问题求助

错误根源 #

你碰到的RangeError (index): Invalid value: Only valid value is 0: 1，核心问题是在ListView.builder里复用了同一个index访问两个独立数组：

• users[index]是遍历全局用户列表的索引
• 但users[index].facilities![index]用同一个索引去访问该用户的设施列表，这完全不合理——每个用户的设施数量和它在用户列表中的位置没有关联，当某个用户的设施数小于当前index时，就会触发数组越界。

另外，代码里直接用facilities!强制解包，还存在空指针风险，若某个用户的facilities为null，会直接崩溃。

修复方案 #

根据不同需求，提供两种实用修复方式：

方式1：展示用户的首个设施ID（若存在） #

如果只需展示每个用户的第一个设施，或者确保每个用户至少有一个设施：

ListView.builder(
  itemCount: users.length, // 必须指定列表长度，避免无限加载
  itemBuilder: (context, index) {
    final user = users[index];
    String facilityInfo = "无关联设施";
    // 先判空再安全访问
    if (user.facilities != null && user.facilities!.isNotEmpty) {
      facilityInfo = user.facilities![0].facilityId.toString();
    }
    return ListTile(
      title: Text(user.userName),
      subtitle: Text(facilityInfo),
    );
  },
);

方式2：嵌套列表展示用户的所有设施 #

如果需要展示每个用户的全部设施，可在列表项中嵌套子列表：

ListView.builder(
  itemCount: users.length,
  itemBuilder: (context, userIndex) {
    final user = users[userIndex];
    return ListTile(
      title: Text(user.userName),
      subtitle: user.facilities == null || user.facilities!.isEmpty
          ? const Text("无关联设施")
          : Column(
              crossAxisAlignment: CrossAxisAlignment.start,
              children: user.facilities!.map((facility) {
                return Text("设施ID：${facility.facilityId}");
              }).toList(),
            ),
    );
  },
);

关键注意事项 #

• 务必给ListView.builder指定itemCount: users.length，否则组件会无限尝试创建列表项
• 永远不要强制解包可空类型变量（比如facilities!），先判断null和非空后再安全访问
• 不同数组的索引要独立使用，用户列表的索引和单个用户的设施列表索引没有关联

内容的提问来源于stack exchange，提问作者Ameen Ul Islam