Flutter：如何将记录列表作为数组存入Cloud Firestore单文档

我在Flutter开发中使用Cloud Firestore时遇到数据存储问题：希望每次点击按钮时，将新增的记录添加到单个文档的murajaatRecords数组中，但目前每次点击都会创建新文档，每个文档仅存一条记录。

问题核心原因 #

你生成文档引用时使用了无参数的doc()方法，该方法会每次生成一个随机ID的新文档，而非定位到同一个已有文档。此外，原本的事务逻辑冗余，FieldValue.arrayUnion本身支持原子性的数组元素追加，无需复杂的存在性判断。

解决方案步骤 #

1. 固定目标文档ID #

给用户的murajaat记录文档指定固定ID（比如user_murajaat），确保每次操作都指向同一个文档，而非随机生成的新文档。

2. 简化Firestore操作逻辑 #

使用set方法并设置merge: true，结合arrayUnion实现原子性追加。arrayUnion会自动处理两种场景：

• 若文档不存在：自动创建文档并初始化数组
• 若文档已存在：将新元素追加到数组中

修改后代码示例 #

Firestore上传函数（核心修改） #

Future<void> markMurajaat({required RecordModel recordModel}) async {
  // 固定文档ID，确保每次操作同一个用户的同一份记录文档
  final docRef = _firebaseFirestore
      .collection(FirestoreConstants.pathUserCollection)
      .doc(_firebaseAuth.currentUser!.uid)
      .collection(FirestoreConstants.pathMurajaatRDCollection)
      .doc('user_murajaat'); // 自定义固定ID，可根据业务调整

  // 使用set + merge: true，无需事务和存在性判断
  await docRef.set(
    recordModel.toJson(recordModel),
    SetOptions(merge: true),
  ).then((value) => print('Record added to array'),
      onError: (e) => print('Error adding record: $e'));
}

模型类toJson方法（无需修改，确认逻辑正确） #

Map<String, dynamic> toJson(RecordModel records) {
  return {
    'murajaatRecords': FieldValue.arrayUnion([
      {
        'juz': records.juz,
        'surah': records.surah,
        'page': records.page,
        'grade': records.grade,
      }
    ])
  };
}

控制器与按钮逻辑（无需修改） #

控制器的markRecord方法和按钮点击逻辑保持原样即可，核心问题已在Firestore操作层解决。

补充说明 #

• FieldValue.arrayUnion会自动过滤数组中的重复元素，若业务允许重复记录，可调整模型结构加入唯一标识字段（如时间戳）来区分。
• 固定文档ID可根据业务需求自定义，只要保证每个用户对应唯一的记录文档即可。

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