Firestore更新嵌套对象时新增us.0.messages数据出现覆盖如何解决

问题原因 #

直接对us.0.messages字段赋值会整体替换该字段的原有值，因此会导致历史消息全部被覆盖。

解决方案 #

如果us.0.messages为数组类型，使用Firestore内置的arrayUnion操作符实现追加，该操作符只会向数组末尾新增元素，不会修改原有内容。

代码示例 #

Web SDK v9（模块化版本）

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

const salonDocRef = doc(firestore, "salon", idSalon);
await updateDoc(salonDocRef, {
  "us.0.messages": arrayUnion(message)
});

Web SDK v8（命名空间版本）

firestore.collection("salon").document(idSalon).update({
  "us.0.messages": firebase.firestore.FieldValue.arrayUnion(message)
});

注意事项 #

• arrayUnion自带去重逻辑：如果传入的message和数组内已有元素完全一致，不会重复写入。如果业务需要允许完全重复的消息，需要先读取完整的messages数组，手动push新元素后再将整个数组写回字段。
• 操作前请确认us是数组类型、索引为0的元素存在、且us.0.messages本身为数组类型，否则会触发操作异常。
• 如果us.0.messages是map类型而非数组，需要追加新的键值对时，直接指定完整的新键路径即可，例如要新增key为msg_1690000000的消息，写法为：

  updateDoc(salonDocRef, {
    "us.0.messages.msg_1690000000": message
  })
  

  该写法不会覆盖map下的其他已有键值对。

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