如何在向Cloud Firestore添加数据前获取文档唯一ID

当然可以提前获取Firestore文档的唯一ID！其实Firestore提供了非常直接的方式实现这一点，完全不需要分“添加文档→更新ID”两步操作，能一次性把ID包含在文档数据里完成写入，彻底避免更新失败带来的风险。

核心思路 #

Firestore的doc()方法如果不传入任何ID参数，会自动生成一个包含唯一ID的文档引用。你可以先拿到这个ID，把它赋值给你的数据模型，再通过这个文档引用的set()方法完成一次性写入，整个过程只需要一次原子操作。

修改后的实现代码 #

结合你现有的代码，修改后的addSiteFireStore方法如下：

Future<String> addSiteFireStore(SiteModel siteModel) async {
  try {
    // 1. 生成带唯一ID的空文档引用（此时还未写入数据）
    DocumentReference<SiteModel> newDocRef = sitesRef.doc();
    // 2. 将生成的唯一ID赋值给模型的docId字段
    siteModel.docId = newDocRef.id;
    // 3. 一次性写入包含ID的完整文档数据
    await newDocRef.set(siteModel);
    
    _logger.fine("Link added successfully");
    return "Link added successfully";
  } on Exception catch (_) {
    _logger.shout("Could not add link.Please try again");
    return "Could not add link.Please try again";
  }
}

为什么这个方案更可靠 #

• 全程只需要一次Firestore写操作，不存在“添加成功但更新失败”的中间状态，数据一致性更强；
• 逻辑和你熟悉的Realtime Database push().getKey()完全对齐，都是提前生成唯一标识再写入数据；
• 避免了后续因文档ID未更新导致的无法访问问题。

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