Flutter中Firebase获取Courses集合字段仅能拿到第一个且报错如何解决

云上老周

2026-9-29

问题根因

字段名不匹配：你代码中写的Course name与Firebase控制台内对应字段的拼写、大小写、空格数不完全一致，是出现该报错的最高频原因
集合内存在缺失字段的文档：Courses集合中部分文档未设置Course name字段，遍历到该类文档时会触发字段不存在的异常
集合路径错误：代码访问的集合路径与实际存储Courses数据的集合路径不匹配，拿到的是其他结构的文档数据

解决方案

核对字段名
打开Firebase控制台进入Courses集合，逐字核对目标字段的命名，确保代码中doc["Course name"]的写法与控制台内的字段名完全相同，包括大小写、空格、特殊符号等所有字符。
增加字段容错校验
调整代码，先将DocumentSnapshot转为Map后做存在性判断，避免缺失字段直接抛出异常，修改后的代码示例如下：

itemBuilder: (context, index) {
  DocumentSnapshot doc = snapshot.data!.docs[index];
  Map<String, dynamic> docData = doc.data() as Map<String, dynamic>;
  // 字段不存在时返回空字符串避免崩溃
  String courseCode = docData.containsKey("Course code") ? docData["Course code"].toString() : "";
  String courseName = docData.containsKey("Course name") ? docData["Course name"].toString() : "";
  return ListTile(
    contentPadding: EdgeInsets.symmetric(horizontal: 30, vertical: 10),
    selectedTileColor: Color(0xffE5E5E5),
    title: Text.rich(
      TextSpan(
        text: courseCode,
        children: <TextSpan>[
          TextSpan(text: ":"),
          TextSpan(text: courseName),
        ],
      ),
    ),
  );
}