如何向Firestore添加单个字段？实现仅新增photoUrl的Patch请求

你对Firestore的update()方法有误解——它不会覆盖整个文档，只会更新你指定的字段，完全符合你要的Patch效果。如果文档原本存在其他字段，update只会新增或修改你传入的键值对，其他字段保持不变。

实现步骤 #

• 用户完成认证后，在个人资料页面选择图片并上传到Firebase Storage，获取图片的下载URL。
• 调用Firestore的update()方法，仅传入photoUrl字段及其值，即可完成单个字段的新增/更新。

代码示例（以JavaScript为例） #

假设你已经获取了当前认证用户的UID，以及图片的下载URL：

import { getFirestore, doc, updateDoc } from "firebase/firestore";

const db = getFirestore();
const userDocRef = doc(db, "users", currentUser.uid); // 假设用户数据存在"users"集合下，文档ID为用户UID

// 仅新增/更新photoUrl字段
await updateDoc(userDocRef, {
  photoUrl: "从Storage获取的图片下载URL"
});

补充说明 #

如果目标文档还不存在，update()会报错，这种情况下可以先用set()方法并设置merge: true选项，同样能实现只新增指定字段的效果：

import { getFirestore, doc, setDoc } from "firebase/firestore";

await setDoc(userDocRef, {
  photoUrl: "图片下载URL"
}, { merge: true });

merge: true会让set操作只合并传入的字段，不覆盖文档中已有的其他数据，和update的效果一致，但能处理文档不存在的场景。

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