如何单次写入更新Firestore Map多个值且不覆盖整个Map

核心实现逻辑 #

要实现仅1次写入操作更新Map类型字段的多个值、且不覆盖Map原有未修改内容，不需要传入全量Map替换，也不需要循环逐字段发请求，只需要将待更新的键以点号拼接嵌套路径的形式作为更新对象的顶级键，所有待更新键值对一次性传入update方法即可。
该方案的特性：

• 仅触发1次文档写入操作，不会产生额外写开销
• Map中未被列入更新参数的原有字段会完整保留，不会被覆盖
• 支持多层嵌套Map更新，点号路径规则通用

正确代码示例（Dart/Flutter） #

// 初始化批量更新参数
final Map<String, dynamic> batchUpdateParams = {};

// 遍历待更新的键值对，拼接嵌套路径
for (final MapEntry entry in someGientMap.entries) {
  batchUpdateParams['FirestoreGiantMap.${entry.key}'] = entry.value;
}

// 单次提交所有更新
await db.doc('document path').update(batchUpdateParams);

原有两种实现的缺陷 #

• 全量传入Map替换的方案：Firestore会将FirestoreGiantMap字段整体替换为你传入的新Map，原有Map中未包含在新Map里的键会被全部删除，属于全量覆盖，不符合部分更新需求。
• 循环逐字段调用update的方案：每一次循环都会发起独立的写入请求，更新N个键就会产生N次文档写入，既会增加写入计费成本，也可能因为多次请求的时序问题导致数据一致性异常。

补充说明 #

如果需要删除Map中的指定键，只需要给对应点号路径的键赋值FieldValue.delete()即可，同样支持和其他更新操作合并到同一次写入请求中处理。

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