FirebaseFirestore获取集合内文档UID与对应数据的实现方法

• 文档引用逻辑错误：FirebaseFirestore.instance.collection('Data').doc()无参调用时，会生成一个指向随机ID的空临时文档引用，既不会匹配你已经创建的4个带固定UID的文档，也无法获取整个Collection下的所有文档内容。
• 流类型不匹配：你需要遍历Collection下的全部文档，却使用了单文档监听的流，返回的DocumentSnapshot仅代表单个文档的内容，和你的需求场景不匹配。
• 打印逻辑问题：直接拼接$docSnapshot时，因为DocumentSnapshot类没有自定义toString方法，默认只会输出Instance of Document snapshot，必须手动读取对象的属性才能拿到具体值。

1. 调整流的监听逻辑 #

需要监听Collection级别的快照，而不是单文档的快照，修正后流的定义为：

// 监听整个Data集合的实时更新，返回类型为QuerySnapshot
Stream<QuerySnapshot> petData = FirebaseFirestore.instance.collection('Data').snapshots();

2. 调整StreamBuilder的类型与解析逻辑 #

完整的可运行代码示例如下，包含状态判断、文档UID与数据的提取逻辑：

Widget build(BuildContext context) {
  return StreamBuilder<QuerySnapshot>(
    stream: petData,
    builder: (context, AsyncSnapshot<QuerySnapshot> snapshot) {
      // 处理加载中状态
      if (snapshot.connectionState == ConnectionState.waiting) {
        return const Center(child: CircularProgressIndicator());
      }
      // 处理报错状态
      if (snapshot.hasError) {
        return const Center(child: Text('数据加载失败'));
      }
      // 拿到集合快照
      final querySnapshot = snapshot.data;
      if (querySnapshot == null || querySnapshot.docs.isEmpty) {
        return const Center(child: Text('暂无数据'));
      }

      // 遍历获取每个文档的UID与对应数据
      final List<Map<String, dynamic>> docList = querySnapshot.docs.map((doc) {
        // 提取文档唯一UID
        final String docUid = doc.id;
        // 提取文档内存储的6个字段数据
        final Map<String, dynamic> docFields = doc.data() as Map<String, dynamic>;
        // 组合成带UID的数据源，方便后续ListView展示
        return {
          'uid': docUid,
          'data': docFields,
        };
      }).toList();

      // 替换原有ListView逻辑，直接使用docList作为数据源
      return ListView.builder(
        itemCount: docList.length,
        itemBuilder: (context, index) {
          final item = docList[index];
          return ListTile(
            title: Text('文档UID：${item['uid']}'),
            subtitle: Text('字段数据：${item['data']}'),
          );
        },
      );
    },
  );
}

• 如果需要获取特定单个文档的内容，必须在.doc()括号内传入文档的固定UID，否则生成的引用无实际业务意义。
• 提取文档数据时，必须通过doc.id拿UID、doc.data()拿字段，直接打印DocumentSnapshot实例本身不会输出可读内容。
• 这个实现和你之前已经能正常拉取数据通过ListView展示的逻辑是完全兼容的，只是补全了文档UID的提取步骤。

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