如何在Flutter中通过文档引用获取Firebase文档的JSON数据？

单次获取文档数据 #

如果只需要一次性拉取文档数据，使用get()方法即可：

// 假设你已持有目标文档的DocumentReference实例 docRef
try {
  DocumentSnapshot snapshot = await docRef.get();
  if (snapshot.exists) {
    // 将文档数据转为Map类型使用
    Map<String, dynamic> docData = snapshot.data() as Map<String, dynamic>;
    // 这里处理你的数据逻辑，比如赋值给变量、更新UI等
    print('文档内容：$docData');
  } else {
    print('指定的文档不存在');
  }
} catch (error) {
  print('获取数据出错：$error');
}

实时监听文档变化 #

如果需要监听文档的实时更新（比如文档内容被修改、删除时自动同步），使用snapshots()方法订阅数据流：

// 订阅文档的实时更新
StreamSubscription<DocumentSnapshot> docSubscription = docRef.snapshots().listen((snapshot) {
  if (snapshot.exists) {
    Map<String, dynamic> docData = snapshot.data() as Map<String, dynamic>;
    print('实时更新的文档内容：$docData');
    // 这里可以通过setState更新Flutter UI，或处理其他业务逻辑
  } else {
    print('文档已被删除');
  }
});

// 当不再需要监听时，记得取消订阅以避免内存泄漏
// docSubscription.cancel();

注意事项 #

• 确保你的Flutter项目已添加cloud_firestore依赖（在pubspec.yaml中配置）
• 检查Firebase控制台的Firestore安全规则，确保当前用户有读取该文档的权限（测试阶段可使用临时规则，上线前需配置严格权限）

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