Flutter写入Firestore时如何避免相同文档ID被覆盖？

1. 写入前先检查文档是否存在 #

在执行写入操作前，先查询目标文档是否存在，仅当文档不存在时才写入数据：

final docRef = FirebaseFirestore.instance.collection('your_collection').doc(targetDocId);
final docSnapshot = await docRef.get();
if (!docSnapshot.exists) {
  await docRef.set({
    // 填充你的数据字段
    'title': '示例内容',
    'createTime': DateTime.now()
  });
} else {
  // 文档已存在时的处理逻辑，比如提示用户
  print('该ID的文档已存在，无法重复写入');
}

2. 用事务保证原子性 #

如果担心多客户端并发写入同一ID的场景，用事务来确保「检查文档是否存在+写入」的操作是原子性的，避免出现竞争条件：

await FirebaseFirestore.instance.runTransaction((transaction) async {
  final docSnapshot = await transaction.get(docRef);
  if (!docSnapshot.exists) {
    transaction.set(docRef, {
      // 你的数据内容
    });
  }
});

3. 设置Firestore安全规则（推荐） #

从服务端层面限制写入行为，直接在Firebase控制台的Firestore安全规则中添加约束，避免客户端代码被绕过：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /your_collection/{docId} {
      // 仅允许创建不存在的文档
      allow create: if !exists(/databases/$(database)/documents/your_collection/$(docId));
      // 按需禁止更新/删除已存在的文档
      allow update, delete: if false;
    }
  }
}

客户端写入已存在的文档时会直接报错，你可以在Flutter代码中捕获该错误并提示用户。

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