Flutter中如何从QuerySnapshot流获取Firestore文档ID并传入自定义组件

你无法获取文档ID的核心原因是混淆了DocumentSnapshot实例和data()方法返回的文档字段Map：文档ID是DocumentSnapshot实例自带的属性，不存在于文档字段数据中，直接从实例上获取即可。

正确的StreamBuilder写法参考如下：

StreamBuilder<QuerySnapshot>(
  // 替换为你自己定义的Stream
  stream: FirebaseFirestore.instance
      .collection('notifications')
      .where('parentUID', isEqualTo: FirebaseAuth.instance.currentUser?.uid)
      .orderBy('timestamp', descending: true)
      .snapshots(),
  builder: (context, AsyncSnapshot<QuerySnapshot> snapshot) {
    if (snapshot.hasError) return const Text('数据加载失败');
    if (snapshot.connectionState == ConnectionState.waiting) {
      return const Center(child: CircularProgressIndicator());
    }

    return ListView(
      // 遍历QuerySnapshot中的所有DocumentSnapshot
      children: snapshot.data!.docs.map((DocumentSnapshot doc) {
        // 直接从DocumentSnapshot实例取id
        String docId = doc.id;
        // 调用data()获取文档内的字段数据
        Map<String, dynamic> docFields = doc.data()! as Map<String, dynamic>;

        return adminNotifCard(
          docID: docId,
          text1: docFields['你的text1对应的字段名'],
          text2: docFields['你的text2对应的字段名'],
        );
      }).toList(),
    );
  },
)

常见错误写法避坑：

• 不要写成doc.data()?.id：data()返回的是文档字段的Map对象，本身没有id属性，运行会报错
• 如果你用了withConverter做类型安全的模型转换，依然可以直接访问doc.id获取文档ID，和转换器逻辑无关

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