Firestore使用set方法加{merge:true}参数未避免覆盖已存在文档如何解决？

核心原因说明 #

set()搭配{ merge: true }的原生逻辑是：如果目标文档存在，仅覆盖你传入的字段，文档内其余未传入的字段会保留；如果目标文档不存在，会直接用传入的字段创建新文档。如果你的预期是文档已存在时完全不执行任何写入操作，那该参数本身就不符合你的需求，属于功能预期偏差。

除了预期偏差外，常见的不生效原因还有以下几类：

• 文档ID不固定：this.id每次写入时取值发生变化，导致每次调用doc()方法都指向一个不存在的新文档，此时merge参数不会生效，会直接创建新文档。
• 安全规则限制：Firestore安全规则未开通对应文档的修改权限，写入请求被拦截，导致你误以为参数不生效。
• 内容无差异：测试时传入的body值和目标文档中已有的body值完全一致，写入前后文档内容无变化，导致看起来没有生效。
• SDK版本bug：过旧的Firebase JS SDK版本存在已知的merge参数偶发不生效问题。

处理方案 #

• 确认需求匹配：如果你的实际需求是「文档不存在时创建，文档已存在时完全不修改」，请使用事务实现对应逻辑，代码如下：

const docRef = firebase.firestore().collection('test_collection').doc(this.id);
await firebase.firestore().runTransaction(async (transaction) => {
  const targetDoc = await transaction.get(docRef);
  // 仅当文档不存在时执行写入
  if (!targetDoc.exists) {
    transaction.set(docRef, {
      body: this.body
    });
  }
})

• 校验文档ID：写入前后打印this.id的值，确认每次都指向同一个目标文档，不要动态生成随机ID。
• 排查安全规则：检查Firestore控制台的安全规则配置，确认当前账号拥有对应文档的修改权限，示例参考配置如下：

match /test_collection/{documentId} {
  allow create, update: if request.auth != null; // 可根据业务场景调整权限逻辑
}

• 验证写入效果：测试时使用和旧文档不同的body值，写入完成后主动调用get()方法获取最新文档内容，不要依赖前端缓存判断是否生效。
• 升级SDK版本：将Firebase JS SDK升级到官方最新稳定版，规避版本已知问题。

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