Flutter中如何遍历Firestore文档的字段？

问题原因 #

你直接将DocumentSnapshot实例强制转换为Map<String, dynamic>，但DocumentSnapshot本身并非Map类型，它是封装文档数据的快照对象，因此触发了类型不匹配的错误。

修复后的代码 #

FutureBuilder(
  future: FirebaseFirestore.instance.collection('collection').doc('doc').get(),
  builder: (context, AsyncSnapshot<DocumentSnapshot> snapshot) {
    if (snapshot.hasData && snapshot.data!.exists) {
      // 通过data()方法获取文档的字段映射
      Map<String, dynamic> data = snapshot.data!.data() as Map<String, dynamic>;
      
      // 遍历所有字段键
      for (var entry in data.keys) {
        // 执行自定义操作，例如打印字段信息
        print('字段名: $entry, 对应值: ${data[entry]}');
      }
      
      // 返回对应Widget，示例用Text展示状态
      return Text('文档字段遍历完成');
    } else if (snapshot.hasError) {
      return Text('加载失败: ${snapshot.error}');
    }
    // 加载中状态组件
    return CircularProgressIndicator();
  },
)

关键说明 #

• 必须调用snapshot.data!.data()方法才能获取文档的实际字段Map，而非直接转换快照对象。
• 增加snapshot.data!.exists判断，避免文档不存在时调用data()返回null引发异常。
• FutureBuilder的builder函数必须返回Widget，原代码缺失返回值会导致编译错误。

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