Firestore Web V9：如何更新子集合中的文档

核心思路 #

只要你持有目标文档的ID，无需依赖集合组查询，直接通过完整文档路径定位文档引用，即可调用update()方法完成字段更新（update()仅修改指定字段，不会覆盖整个文档）。

各平台代码示例 #

Web（JavaScript）

// 构造目标文档的完整引用
// 替换占位符为实际的父文档ID和目标文档ID
const docRef = db.collection("transactions")
  .doc("父文档ID")
  .collection("pullout_requests")
  .doc("中间文档ID")
  .collection("requests")
  .doc("你的目标文档ID");

// 更新指定字段
docRef.update({
  status: "approved",
  updatedAt: new Date()
})
.then(() => console.log("文档更新成功"))
.catch(err => console.error("更新失败:", err));

Android（Kotlin）

val docRef = FirebaseFirestore.getInstance()
    .collection("transactions")
    .doc("父文档ID")
    .collection("pullout_requests")
    .doc("中间文档ID")
    .collection("requests")
    .doc("你的目标文档ID")

val updateFields = hashMapOf(
    "status" to "approved",
    "updatedAt" to FieldValue.serverTimestamp()
)

docRef.update(updateFields)
    .addOnSuccessListener { Log.d("Firestore", "文档更新成功") }
    .addOnFailureListener { e -> Log.w("Firestore", "更新失败", e) }

iOS（Swift）

let docRef = Firestore.firestore()
    .collection("transactions")
    .document("父文档ID")
    .collection("pullout_requests")
    .document("中间文档ID")
    .collection("requests")
    .document("你的目标文档ID")

docRef.updateData([
    "status": "approved",
    "updatedAt": FieldValue.serverTimestamp()
]) { error in
    if let error = error {
        print("更新失败：\(error)")
    } else {
        print("文档更新成功")
    }
}

若未知父文档ID的处理方式 #

如果只知道目标文档ID和子集合名称，可通过集合组查询定位文档后更新：

// Web端集合组查询示例
db.collectionGroup("requests")
  .where(firebase.firestore.FieldPath.documentId(), "==", "你的目标文档ID")
  .get()
  .then(snapshot => {
    if (!snapshot.empty) {
      snapshot.docs[0].ref.update({ status: "approved" });
    } else {
      console.log("未找到目标文档");
    }
  });

补充说明 #

你之前查看的文档是集合组查询的专属内容，而文档更新属于写入操作范畴。只要能获取到文档的引用（无论嵌套层级多少），都可以直接调用更新方法。

内容的提问来源于stack exchange，提问作者Jerwin Mathew Aton