Cloud Functions中Firestore自增后无法取值并更新用户文档问题

问题核心原因 #

你的代码存在异步操作顺序错误的问题：

• memCounter.update() 和后续的 get() 是异步执行的，但你没有将它们与后面的用户文档创建操作串联起来。导致设置用户文档的代码先于会员编号获取完成前执行，此时 newMemNum 还未被赋值，同时 Cloud Functions 可能在异步操作完成前就已终止，使得后续逻辑（比如 console.log('New Member Number: ...')）无法执行。
• newMemNum 未提前声明，存在作用域隐患。

修正方案（使用 Async/Await 简化异步流程） #

推荐使用 async/await 来保证异步操作的顺序，同时确保所有异步任务完成后再结束函数：

// Create User Document onCreate
const createProfile = async (userRecord) => { // 标记为 async 函数
  const uid = userRecord.uid;
  const docId = userRecord.uid;
  const fullName = userRecord.displayName || 'New User';
  const memStatus = 'Unfinancial';
  const isAdmin = false;
  const isNew = true;
  const email = userRecord.email;
  const photoUrl = userRecord.photoUrl;
  const phone = '0444 123 456';
  const createdAt = admin.firestore.FieldValue.serverTimestamp();

  const memNumInc = admin.firestore.FieldValue.increment(1);
  const memCounter = admin.firestore().collection(`mem_num`).doc(`a1lDbrsoXjfKeosEkDtw`);

  try {
    // 第一步：自增会员编号计数器
    await memCounter.update({ number: memNumInc });
    // 第二步：获取更新后的会员编号
    const snap = await memCounter.get();
    const data = snap.data();
    const newMemNum = data?.number; // 使用可选链避免空值报错

    console.log('New Member Number: ' + newMemNum);

    // 第三步：创建用户文档，此时 newMemNum 已正确赋值
    await afs
      .collection(`users`)
      .doc(docId)
      .set({
        uid: uid,
        docId: docId,
        fullName: fullName,
        joined: createdAt,
        memNum: newMemNum,
        memStatus: memStatus,
        isAdmin: isAdmin,
        isNew: isNew,
        email: email,
        photoUrl: photoUrl,
        phone: phone,
        addedOn: createdAt,
        updatedOn: createdAt
      });

    console.log('User Created Successfully: ' + uid);
  } catch (e) {
    console.log('Error: ' + e.message);
    throw e; // 抛出错误让 Cloud Functions 记录异常
  }
};

exports.authOnCreate = functions.auth.user().onCreate(createProfile);

关键改进点 #

1. 异步流程同步化：用 async/await 替代嵌套的 .then()，确保会员编号自增、获取、用户文档创建按顺序执行。
2. 错误处理：统一用 try/catch 捕获所有异步操作的错误，避免静默失败。
3. 变量作用域：在函数内部声明 newMemNum，避免全局变量污染。
4. 空值安全：使用 data?.number 处理计数器文档可能不存在的情况（可选，根据你的业务场景调整）。

替代方案（Promise 链式调用） #

如果你偏好使用 .then() 风格，可以将用户文档创建操作嵌套在会员编号获取的回调中：

const createProfile = (userRecord) => {
  const uid = userRecord.uid;
  const docId = userRecord.uid;
  const fullName = userRecord.displayName || 'New User';
  const memStatus = 'Unfinancial';
  const isAdmin = false;
  const isNew = true;
  const email = userRecord.email;
  const photoUrl = userRecord.photoUrl;
  const phone = '0444 123 456';
  const createdAt = admin.firestore.FieldValue.serverTimestamp();

  const memNumInc = admin.firestore.FieldValue.increment(1);
  const memCounter = admin.firestore().collection(`mem_num`).doc(`a1lDbrsoXjfKeosEkDtw`);

  // 链式调用所有异步操作
  return memCounter.update({ number: memNumInc })
    .then(() => memCounter.get())
    .then((snap) => {
      const data = snap.data();
      const newMemNum = data?.number;
      console.log('New Member Number: ' + newMemNum);
      // 在此处执行用户文档创建
      return afs.collection(`users`).doc(docId).set({
        uid: uid,
        docId: docId,
        fullName: fullName,
        joined: createdAt,
        memNum: newMemNum,
        memStatus: memStatus,
        isAdmin: isAdmin,
        isNew: isNew,
        email: email,
        photoUrl: photoUrl,
        phone: phone,
        addedOn: createdAt,
        updatedOn: createdAt
      });
    })
    .then(() => console.log('User Created Successfully: ' + uid))
    .catch((e) => {
      console.log('Error: ' + e.message);
      throw e;
    });
};

exports.authOnCreate = functions.auth.user().onCreate(createProfile);

这个方案的核心是将所有异步操作通过 .then() 串联，确保前一步完成后再执行下一步，同时函数返回整个 Promise 链，让 Cloud Functions 等待所有操作完成。

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