Firestore如何仅更新文档map类型字段的单个键值对？

要实现map类型字段的单键值局部更新，不需要上传完整map，直接使用Firestore的点表示法指定嵌套字段路径即可，不会覆盖map下其他未指定的键值对。

你当前的实现会覆盖整个map的原因是：直接将完整的savedNames map序列化后传入update方法，相当于直接为顶层names字段赋值新的map，自然会覆盖该字段原有全部内容。

正确实现代码如下：

// 定义需要更新的键和对应新值
String targetKey = "your_target_key";
dynamic targetValue = "your_new_value";

await FirebaseFirestore.instance
    .collection(namesCollectionName)
    .doc(docId)
    // 用「names.键名」的格式指定嵌套路径，仅更新该键对应的值
    .update({"names.$targetKey": targetValue})
    .whenComplete(() => developer.log("Update saved names success"))
    .catchError((error) {
  developer.log("Update saved names failed: $error");
  throw Exception("Update saved names failed: $error");
});

补充说明：

• 若需要同时更新同一个map下的多个键，只需在update的参数Map中增加多组"names.键名": 新值的键值对即可，同样不会影响其他未指定的键。
• 如果指定的键在原names map中不存在，Firestore会自动新增该键值对，无需额外做存在性判断。
• 该方案相比全量上传map效率更高，不仅传输数据量更小，还可以避免并发修改时覆盖其他客户端更新的同map下的其他键值对。

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