如何为单个Firestore文档添加带唯一字段标识的多个映射？

针对你遇到的Firestore映射添加选项易覆盖、无自增ID的问题，这里有几个实用的解决方案：

方案1：用Firestore自动生成的唯一ID作为映射键 #

Firestore可以通过doc().id生成全局唯一的字符串ID，用它作为映射的键，完全不用担心重复覆盖的问题。配合SetOptions(merge: true)更新文档，只会新增键值对，不会覆盖整个映射。

示例代码（Flutter）：

// 生成唯一键（无需实际创建文档，仅用ID）
final newOptionId = FirebaseFirestore.instance.collection('temp').doc().id;

// 更新下拉选项映射
await FirebaseFirestore.instance
    .collection('your_collection') // 替换为你的集合名
    .doc('your_target_doc') // 替换为存储选项的文档ID
    .set(
  {
    'dropdown_options': {
      newOptionId: {
        'label': '用户输入的新选项文本',
        'value': '对应的选项值（可选）'
      }
    }
  },
  SetOptions(merge: true), // 关键：合并更新，不覆盖原有映射
);

这个方案最稳妥，唯一ID不会重复，操作简单，适合绝大多数场景。

方案2：以选项文本为键（需先检查重复） #

如果希望映射的键有实际意义（比如直接用选项文本），可以先查询当前映射中是否存在该键，确认不存在后再添加。

示例代码：

final docRef = FirebaseFirestore.instance
    .collection('your_collection')
    .doc('your_target_doc');

// 获取当前的下拉选项映射
final docSnapshot = await docRef.get();
final currentOptions = docSnapshot.data()?['dropdown_options'] as Map<String, dynamic>? ?? {};

final newOptionLabel = '用户输入的新选项文本';
// 检查键是否已存在
if (!currentOptions.containsKey(newOptionLabel)) {
  // 使用点语法更新映射中的单个键值对
  await docRef.update({
    'dropdown_options.$newOptionLabel': {
      'value': '对应的选项值（可选）'
    }
  });
} else {
  // 提示用户：该选项已存在，请更换内容
}

注意：如果用户可能输入重复的选项文本，这个方案必须加检查逻辑，否则会覆盖原有选项。

方案3：改用数组存储选项（替代映射） #

如果不需要通过键快速查找选项，也可以把下拉选项存在数组中，用FieldValue.arrayUnion来添加新元素（自动避免完全重复的元素）。

示例代码：

await FirebaseFirestore.instance
    .collection('your_collection')
    .doc('your_target_doc')
    .update({
  'dropdown_options': FieldValue.arrayUnion([
    {
      'id': FirebaseFirestore.instance.collection('temp').doc().id,
      'label': '用户输入的新选项文本',
      'value': '对应的选项值（可选）'
    }
  ])
});

读取选项时直接遍历数组即可，适合用户大多只是选择现有选项的场景。

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