如何让Firebase新文档自动添加与文档ID一致的id字段？

方式一：客户端主动生成并写入 #

在创建文档前先手动生成文档ID，再将该ID同时作为文档ID和内部id字段的值写入，这是最直接的实现方式：

// 目标集合名替换为你的实际集合
const targetCollection = db.collection('your-collection');
// 生成文档ID
const docId = targetCollection.doc().id;
// 创建文档并同步id字段
await targetCollection.doc(docId).set({
  id: docId,
  // 其他业务字段
  title: '示例内容',
  createTime: new Date()
});

方式二：云函数自动同步（强一致性保障） #

如果需要强制确保id字段与文档ID一致，避免客户端篡改或遗漏，可以使用Firestore的onCreate触发器，在文档创建后自动补全或修正id字段：

const functions = require("firebase-functions");
const admin = require("firebase-admin");
admin.initializeApp();

exports.syncDocumentId = functions.firestore
  .document('your-collection/{docId}')
  .onCreate((snap, context) => {
    const docId = context.params.docId;
    const currentData = snap.data();
    // 仅当id字段不存在或不一致时更新
    if (!currentData.id || currentData.id !== docId) {
      return snap.ref.update({ id: docId });
    }
    return null;
  });

关于安全规则的说明 #

安全规则无法自动创建或填充字段，它仅能做校验拦截。如果你之前尝试的规则无效，大概率是混淆了规则的作用——规则只能限制客户端写入时，id字段必须与文档ID一致，示例规则如下：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /your-collection/{docId} {
      // 创建文档时必须保证id字段等于文档ID
      allow create: if request.resource.data.id == docId;
      // 更新时不允许修改id字段值
      allow update: if request.resource.data.id == docId && request.resource.data.id == resource.data.id;
    }
  }
}

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