Firebase Firestore能否仅获取文档中的单个字段？

当然可以！Firebase Firestore专门提供了字段筛选的功能，能让你只拉取需要的特定字段，不用获取整个文档的所有数据——这不仅能减少带宽消耗，还能提升请求效率。

下面给你几个主流平台的实现示例，你可以根据自己的开发环境参考：

Web（JavaScript） #

使用select()方法指定要获取的字段，之后从文档快照中提取对应值：

import { doc, getDoc, select } from "firebase/firestore";

// 替换成你的集合名和文档ID
const docRef = doc(db, "users", "user123");
// 仅请求Name字段
const docSnap = await getDoc(docRef, select("Name"));

if (docSnap.exists()) {
  const userName = docSnap.get("Name");
  console.log("用户名称：", userName);
} else {
  console.log("目标文档不存在！");
}

Android（Kotlin） #

在获取文档时调用select()方法指定字段：

val db = Firebase.firestore
val docRef = db.collection("users").document("user123")

docRef.select("Name")
    .get()
    .addOnSuccessListener { document ->
        if (document.exists()) {
            val userName = document.getString("Name")
            Log.d("Firestore", "用户名称：$userName")
        } else {
            Log.d("Firestore", "文档不存在")
        }
    }
    .addOnFailureListener { exception ->
        Log.e("Firestore", "获取字段失败", exception)
    }

iOS（Swift） #

可以通过fields()方法指定要获取的字段：

import FirebaseFirestore

let db = Firestore.firestore()
let docRef = db.collection("users").document("user123")

// 仅请求Name字段
docRef.fields(["Name"]).getDocument { document, error in
    guard let document = document, document.exists else {
        print("文档不存在或请求失败")
        return
    }
    if let userName = document.get("Name") as? String {
        print("用户名称：\(userName)")
    }
}

额外提示 #

• 字段名是区分大小写的，一定要和你Firestore数据库中定义的字段名完全匹配（比如数据库里是Name就别写成name）；
• 这个方法同样适用于集合查询——如果你想查询某个集合下所有文档的Name字段，只需要在查询链中加上字段筛选方法即可；
• 文档快照中只会包含你指定的字段，其他字段的数据不会被返回，所以如果尝试获取未指定的字段，会得到空值。

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