Firestore向map字段批量新增键值且不覆盖原有数据的实现方法

直接对fruits字段传入完整新对象执行update时，Firestore会将整个fruitsMap字段替换为传入的新对象，原有未在新对象中声明的键（apple、orange）会被直接删除。

Firestore对嵌套Map类型字段的局部更新，支持点号路径语法：只需要把要新增/更新的嵌套字段，拼接为上层字段名.嵌套键名的格式作为更新对象的键，就只会修改你指定的嵌套键，不会影响Map下的其他原有数据，不需要提前读取文档拉取旧数据。

批量写入（batch）场景的实现代码如下：

// 待新增的水果条目
const newFruits = { pineapple: 20, cherry: 10, banana: 10 };
// 构造符合点号语法的更新参数
const updatePayload = {};
for (const [fruitName, stock] of Object.entries(newFruits)) {
  updatePayload[`fruits.${fruitName}`] = stock;
}
// 执行批量更新
batch.update(fs.doc(`config/254868`), updatePayload);

补充说明 #

• 该语法对普通文档更新doc.update()、批量写入batch.update()、事务更新全部生效
• 若你传入的嵌套键在原有Map中已经存在，对应值会被新值覆盖；不存在的键会直接追加，不会改动其他原有键
• 执行后最终fruits字段的结果为{ apple: 20, orange: 10, pineapple: 20, cherry: 10, banana: 10 }，符合预期

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