Flutter中向Firebase添加同字段新数据且不覆盖旧数据

你当前的核心问题是：虽然使用了SetOptions(merge: true)，但每次都在更新同一个name和code字段——这两个字段在文档中是唯一的，合并操作只会覆盖同名字段的值，不会自动帮你创建多条用户记录。

要在单个文档中存储多组用户的name和code，推荐两种实现方式：

方案1：用数组存储用户列表 #

利用Firestore的数组类型，将每个用户的信息包装成对象，通过FieldValue.arrayUnion()追加到数组中，实现新增不覆盖：

CollectionReference scatterSignup = FirebaseFirestore.instance.collection('scatterSignup');

onPressed: () async {
  // 包装单条用户数据
  final userItem = {
    'name': username,
    'code': userCode,
    // 可选：添加用户唯一标识（如Firebase Auth的UID），避免重复提交
    // 'userId': FirebaseAuth.instance.currentUser?.uid
  };

  try {
    // 尝试更新数组（文档已存在时）
    await scatterSignup.doc(regionUpload).update({
      'users': FieldValue.arrayUnion([userItem])
    });
  } catch (error) {
    // 文档不存在时，先创建文档并初始化数组
    if (error.code == 'not-found') {
      await scatterSignup.doc(regionUpload).set({
        'users': [userItem]
      });
    } else {
      rethrow;
    }
  }
}

• 说明：arrayUnion会自动跳过数组中完全相同的对象，添加唯一标识后，可精准避免同一用户重复提交。

方案2：用嵌套对象（以唯一标识为键） #

如果偏好键值对结构，可以用用户唯一标识（如UID、时间戳）作为嵌套对象的键，结合merge: true实现新增：

CollectionReference scatterSignup = FirebaseFirestore.instance.collection('scatterSignup');

onPressed: () async {
  // 生成用户唯一标识（优先用Auth的UID，无则用时间戳）
  final uniqueKey = FirebaseAuth.instance.currentUser?.uid ?? DateTime.now().millisecondsSinceEpoch.toString();

  await scatterSignup.doc(regionUpload).set({
    'users': {
      uniqueKey: {
        'name': username,
        'code': userCode
      }
    }
  }, SetOptions(merge: true));
}

• 说明：每次新增用户时只会添加新的键值对，不会覆盖已有数据；若同一用户重复提交，会更新自己的记录（因键相同）。

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