我懂你的困扰！你本来以为设置merge: true就能安全地往现有数组里加新元素，但结果却把原来的[user1, user2]直接换成了[uid]——这其实是对merge参数和Firestore数组操作的理解偏差导致的。

为什么merge: true没起作用？ #

merge: true的作用是保留文档中未被你明确指定的顶级字段，比如如果你的households文档还有houseName这类字段，用set加merge: true不会删掉它。但对于你指定的users字段来说，你是直接给了一个全新的数组值[uid]，Firestore会认为你要把users字段的值替换成这个新数组，而不是往里面追加元素——这和merge开关无关，因为你已经明确指定了该字段的新值。

正确的数组追加方式：用arrayUnion原子操作 #

Firestore提供了专门的数组操作符来处理这类场景，FieldValue.arrayUnion()可以原子性地往数组里添加元素（还会自动去重，避免重复添加同一个UID），而且不需要先读取现有数组再修改，也不会有并发冲突的问题。

把你的代码改成这样：

db.collection('households').doc(householdId)
  .update({
    users: firebase.firestore.FieldValue.arrayUnion(uid)
  })
  .then(() => {
    resolve();
  })
  .catch((error) => {
    reject(error); // 建议把错误传递出去，方便后续调试
  });

补充说明 #

• 如果你确实需要允许重复添加同一个元素（这种场景比较少见），那你可以先读取文档获取现有数组，push新元素后再用set或update写回去，但这种方式要注意并发修改的问题（比如两个用户同时添加元素可能会覆盖彼此的修改），而arrayUnion是原子操作，不会有这个问题。
• 别忘了确保你已经正确导入了firebase.firestore.FieldValue（或者根据你的SDK版本，比如import { FieldValue } from "firebase/firestore";）。

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