Firebase云函数检测emailVerified变更异常：用户集合未创建排查

核心问题分析 #

你的代码存在三个关键问题，导致Firestore未创建文档：

1. 触发器类型错误
   你需要检测emailVerified属性的变更，但当前使用的onCreate触发器仅在用户首次创建时触发。而用户注册时emailVerified默认是false（除非通过特定验证流程创建用户），所以这个条件分支大概率不会执行。

2. 未返回异步操作的Promise
   云函数需要等待异步操作（比如Firestore的create）完成后再终止，否则函数会提前结束，导致Firestore请求未完成。你的代码里没有返回admin.firestore().collection(...).create(...)这个Promise，函数会立即退出，写入操作被中断。

3. 未处理displayName为空的情况
   如果用户创建时没有设置displayName，调用user.displayName.toLowerCase()会抛出Cannot read properties of null (reading 'toLowerCase')错误，导致函数执行失败。

修复后的代码 #

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

exports.emailVerifiedChange = functions.auth.user().onUpdate((change) => {
  const userBefore = change.before;
  const userAfter = change.after;

  // 仅当emailVerified从false变为true时执行后续操作
  if (!userBefore.emailVerified && userAfter.emailVerified) {
    // 处理displayName为空的情况
    const displayName = userAfter.displayName || "匿名用户";
    const searchName = displayName.toLowerCase();

    // 返回Promise，确保云函数等待写入完成
    return admin.firestore().collection(`users`).doc(userAfter.uid).set({
      created: new Date(),
      uid: userAfter.uid,
      name: displayName,
      searchName: searchName,
      userInfo: {
        profilePic: "",
        phoneNumber: userAfter.phoneNumber || "",
        email: userAfter.email
      },
      provider: false
    });
  }

  // 如果没有符合条件的变更，返回空Promise结束函数
  return Promise.resolve();
});

关键修复点说明 #

• 改用onUpdate触发器：监听用户属性的变更，对比变更前后的emailVerified状态，仅当从未验证变为已验证时执行写入操作。
• 返回异步操作Promise：通过return语句返回Firestore的set操作Promise，确保云函数等待写入完成后再终止。这里用set而非create，避免用户UID已存在时抛出错误（可根据需求调整）。
• 处理空值情况：给displayName和phoneNumber设置默认值，避免因空值导致的运行时错误。
• 明确无变更时的返回：当没有符合条件的属性变更时，返回Promise.resolve()，确保函数正常结束。

额外检查项 #

1. 确认云函数已正确部署：运行firebase deploy --only functions重新部署修复后的代码。
2. 检查Firestore权限：确保云函数服务账号有写入users集合的权限（默认情况下云函数拥有全部Firestore权限，若自定义了安全规则需确认规则允许写入）。
3. 查看函数日志：在Firebase控制台的「函数」→「日志」中查看详细错误信息，若仍有问题可定位具体报错点。

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