Flutter调用FirebaseFirestore查询报Valid value range is empty: 0如何解决

• 缺少状态判断：StreamBuilder在流首次返回数据前、请求失败、目标customers集合无数据时，snapshot.data为null或snapshot.data.docs为空数组，直接访问下标[0]会触发数组范围越界错误。
• 遍历逻辑错误：snapshot.data.docs本身就是所有文档的集合，不需要取下标[0]后再做遍历，原写法仅会处理第一条文档的内容，不符合集合遍历的预期。

首先修正数据处理方法，同时在StreamBuilder中增加全场景状态判断：

import 'package:flutter/material.dart';
import 'package:cloud_firestore/cloud_firestore.dart';

// 初始化Firestore实例
FirebaseFirestore firestore = FirebaseFirestore.instance;

// 处理文档转ListTile的逻辑
List<Widget> dataListWidget(AsyncSnapshot<QuerySnapshot> snapshot) {
  // 直接遍历所有docs，不需要取[0]
  return snapshot.data!.docs.map((document) {
    return ListTile(
      title: Text(document["Name"]),
      subtitle: Text(document["City"]),
    );
  }).toList();
}

// StreamBuilder部分实现
Widget buildCustomerList() {
  return StreamBuilder<QuerySnapshot>(
    stream: firestore.collection('customers').snapshots(),
    builder: (context, snapshot) {
      // 加载状态处理
      if (snapshot.connectionState == ConnectionState.waiting) {
        return const Center(child: CircularProgressIndicator());
      }
      // 错误状态处理
      if (snapshot.hasError) {
        return Center(child: Text('加载失败: ${snapshot.error}'));
      }
      // 无数据状态处理
      if (!snapshot.hasData || snapshot.data!.docs.isEmpty) {
        return const Center(child: Text('暂无客户数据'));
      }
      // 有数据时返回列表
      return ListView(
        children: dataListWidget(snapshot),
      );
    },
  );
}

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