Firestore：如何用setDoc向数组添加重复Map元素

Firestore的arrayUnion方法本身就是去重添加逻辑——它会严格对比数组中已有元素和待添加元素的所有键值对，只要完全匹配就不会重复插入，这就是你遇到问题的核心原因。要实现即使内容相同也能添加新Map对象的需求，得换一种方式操作：

方案1：手动获取数组后添加再回写 #

先读取当前文档的players数组，手动把新元素追加进去，再将更新后的数组写回Firestore：

// 获取目标文档引用
const gambleDocRef = doc(firestore, 'gambles', gambleId);
// 读取当前文档数据
const docSnapshot = await getDoc(gambleDocRef);

if (docSnapshot.exists()) {
  const currentData = docSnapshot.data();
  // 复制原数组并追加新元素
  const updatedPlayers = [...(currentData.players || []), {
    balanceDrop: silver,
    id: userId,
    login: userData.login
  }];
  
  // 更新文档
  await updateDoc(gambleDocRef, {
    players: updatedPlayers,
    totalPlayers: increment(1),
    totalSilver: Number(currentData.totalSilver) + Number(silver)
  });
} else {
  // 文档不存在时直接创建
  await setDoc(gambleDocRef, {
    players: [{
      balanceDrop: silver,
      id: userId,
      login: userData.login
    }],
    totalPlayers: 1,
    totalSilver: Number(silver)
  });
}

方案2：用事务处理并发场景 #

如果存在多个用户同时修改同一个文档的情况，上面的普通写法可能出现数据覆盖问题，这时建议用Firestore事务来确保操作的原子性：

await runTransaction(firestore, async (transaction) => {
  const gambleDocRef = doc(firestore, 'gambles', gambleId);
  const docSnapshot = await transaction.get(gambleDocRef);
  
  let updatedPlayers, updatedTotalPlayers, updatedTotalSilver;
  
  if (docSnapshot.exists()) {
    const currentData = docSnapshot.data();
    updatedPlayers = [...(currentData.players || []), {
      balanceDrop: silver,
      id: userId,
      login: userData.login
    }];
    updatedTotalPlayers = (currentData.totalPlayers || 0) + 1;
    updatedTotalSilver = Number(currentData.totalSilver) + Number(silver);
  } else {
    updatedPlayers = [{
      balanceDrop: silver,
      id: userId,
      login: userData.login
    }];
    updatedTotalPlayers = 1;
    updatedTotalSilver = Number(silver);
  }
  
  transaction.set(gambleDocRef, {
    players: updatedPlayers,
    totalPlayers: updatedTotalPlayers,
    totalSilver: updatedTotalSilver
  }, { merge: true });
});

注意事项 #

• 这两种方式都需要读取整个players数组再写入，如果数组规模极大，可能会带来性能开销，需要根据业务场景评估是否适用。
• 高并发场景下优先选择事务方案，避免多人操作导致的数据不一致。

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