Firebase中用Dart更新文档对象数组元素及arrayUnion行为咨询

你的代码行为说明 #

• 这段代码不会更新现有id=1的记录，而是会在status数组中新增一条id=1的记录——除非数组里已经存在一个和你传入的对象完全一致的元素（date和id的值都一模一样），这时arrayUnion会跳过添加操作。
• 如果你想更新数组中id=1的元素，必须先执行删除旧元素的操作，再添加更新后的新元素。

原因解释 #

Firestore的FieldValue.arrayUnion()的核心逻辑是：检查传入的元素是否完全匹配数组中的某一项（对象的所有键值对都要完全相同），不存在就追加，存在则不做任何处理。它没有根据某个特定字段（比如id）匹配并更新元素的能力。

正确的更新实现思路 #

要更新数组中指定id的元素，需要分两步操作（建议用事务保证原子性，避免并发冲突）：

方法1：分步操作 #

// 1. 读取用户文档，获取当前status数组
final docSnapshot = await FirebaseFirestore.instance.collection("users").doc(email).get();
final statusList = List<Map<String, dynamic>>.from(docSnapshot.data()?["status"] ?? []);

// 2. 找到并移除旧的id=1的元素
final oldItem = statusList.firstWhere((item) => item["id"] == 1, orElse: () => {});
if (oldItem.isNotEmpty) {
  await FirebaseFirestore.instance.collection("users").doc(email).update({
    "status": FieldValue.arrayRemove([oldItem])
  });
}

// 3. 添加更新后的新元素
await FirebaseFirestore.instance.collection("users").doc(email).update({
  "status": FieldValue.arrayUnion([{
    "date": "10/15/2022",
    "id": 1
  }]),
});

方法2：事务操作（更安全，适合多用户并发场景） #

await FirebaseFirestore.instance.runTransaction((transaction) async {
  final docRef = FirebaseFirestore.instance.collection("users").doc(email);
  final docSnapshot = await transaction.get(docRef);
  final statusList = List<Map<String, dynamic>>.from(docSnapshot.data()?["status"] ?? []);
  
  // 移除旧的id=1元素
  final oldItemIndex = statusList.indexWhere((item) => item["id"] == 1);
  if (oldItemIndex != -1) {
    transaction.update(docRef, {
      "status": FieldValue.arrayRemove([statusList[oldItemIndex]])
    });
  }
  
  // 添加更新后的元素
  transaction.update(docRef, {
    "status": FieldValue.arrayUnion([{
      "date": "10/15/2022",
      "id": 1
    }])
  });
});

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