Flutter Firebase获取子集合文档报错，求解决方案

你的问题核心是**snapshots()返回的是QuerySnapshot而非单个DocumentSnapshot**，直接访问snapshot.doc属于属性误用，因为QuerySnapshot没有该属性，它包含的是子集合的所有文档列表（docs属性）。

修正步骤 #

• 先处理StreamBuilder的快照状态（加载、错误、无数据场景）
• 通过QuerySnapshot.docs获取子集合的文档列表，再遍历或定位目标文档提取字段

修正后的代码示例 #

StreamBuilder<QuerySnapshot>(
  stream: FirebaseFirestore.instance
      .collection("ADS")
      .doc("你的文档ID") // 替换为实际文档ID
      .collection("子集合名称") // 替换为实际子集合名称
      .snapshots(),
  builder: (context, snapshot) {
    // 处理加载中状态
    if (snapshot.connectionState == ConnectionState.waiting) {
      return const CircularProgressIndicator();
    }

    // 处理错误状态
    if (snapshot.hasError) {
      return Text('加载失败: ${snapshot.error}');
    }

    // 检查是否有有效数据
    if (!snapshot.hasData || snapshot.data!.docs.isEmpty) {
      return const Text('暂无数据');
    }

    // 场景1：遍历子集合所有文档，提取目标字段
    List<Widget> dateItems = [];
    for (var doc in snapshot.data!.docs) {
      String targetDate = doc["The date I want to get"];
      dateItems.add(Text(targetDate));
    }
    return Column(children: dateItems);

    // 场景2：仅获取子集合第一个文档的目标字段
    // var targetDoc = snapshot.data!.docs.first;
    // String targetDate = targetDoc["The date I want to get"];
    // return Text(targetDate);
  },
)

关键说明 #

• snapshot.data是QuerySnapshot类型，其docs属性是子集合内所有DocumentSnapshot的数组
• 单个DocumentSnapshot可通过[]操作符或get()方法提取字段（如doc.get("The date I want to get")）
• 必须先校验快照的有效性（hasData、docs.isEmpty），避免空指针异常

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