Firestore .set({}) 异常：移除Map部分元素后未同步至数据库

问题原因 #

你当前使用SetOptions(merge: true)更新数据时，Firestore的合并逻辑是只同步你提供的字段，不会主动删除原有文档中未包含在新数据里的字段。

举个例子：当你从foodInFridge中移除Beef键后，调用set({'food': foodInFridge}, merge: true)，Firestore只会更新food映射中你提供的Egg数据，不会主动删除原有的Beef键——因为你没有明确告诉它要删除这个键。只有当foodInFridge为空时，整个food字段会被设为空，这才会同步删除所有子键。

解决方案 #

推荐使用原子更新+明确删除的方式，不需要先获取整个food映射，还能避免并发修改的问题：

1. 分情况处理（更高效）

直接根据食物当前数量执行对应操作：

// 先获取目标食物的当前数量
Map<String, dynamic>? foodData = (await _db.collection('families').doc(familyID).get()).data()?['food'][foodName];
if (foodData == null) return;

int currentQuantity = foodData['quantity'];
if (currentQuantity == 1) {
  // 数量为1时，明确删除该食物键
  await _db.collection('families').doc(familyID).update({
    'food.$foodName': FieldValue.delete()
  });
} else {
  // 数量大于1时，原子减1
  await _db.collection('families').doc(familyID).update({
    'food.$foodName.quantity': FieldValue.increment(-1)
  });
}

2. 保留原有逻辑的修复方案

如果你坚持先获取整个food映射再修改，需要替换set(merge: true)为update，强制覆盖food字段：

Map<String, dynamic> foodInFridge = await getDataFromFirestore('families', familyID, 'food');
if (foodInFridge[foodName]['quantity'] == 1) {
  foodInFridge.remove(foodName);
} else {
  foodInFridge[foodName]['quantity'] -= 1;
}

// 用update替换set(merge: true)，确保本地修改的映射完全同步
await _db.collection('families').doc(familyID).update({
  'food': foodInFridge
});

注意：update方法会直接替换整个food字段，不会保留原有的未包含键。

额外提示 #

使用FieldValue.increment和FieldValue.delete属于Firestore的原子操作，能避免多用户同时操作时的数据不一致问题，比先获取再修改的方式更可靠。

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