阻塞式Cloud Function未触发，无法创建Firestore文档求助

我使用以下Cloud Function时，Firebase Auth用户创建功能正常，但未生成Firestore文档。

import { identity } from "firebase-functions/v2";
import * as admin from "firebase-admin";

admin.initializeApp();
const firestore = admin.firestore();

export const createfirestoreuser = identity.beforeUserCreated(async (event) => {
  await firestore.collection("users").doc(event.data.uid).create({
    "id": event.data.uid,
    // TODO: Add defaults
  });
  return;
});

已在Firebase控制台的Auth设置中将阻塞函数配置为createfirestoreuser，但云函数概览显示该函数从未被触发。

排查与解决步骤 #

1. 确认云函数部署状态 #

• 检查终端部署日志，确保createfirestoreuser函数成功部署，无报错。若部署失败，修复问题后重新部署。
• 保证本地代码与云端部署代码一致，避免修改后未重新部署。

2. 验证云函数权限 #

• 云函数需具备Firestore写入权限和Auth触发器权限：
  • 为云函数服务账号（通常是[项目ID]@appspot.gserviceaccount.com）添加Cloud Datastore User角色，确保可写入Firestore。
  • 确认服务账号拥有Firebase Auth Admin相关权限，能接收Auth触发器事件。

3. 检查触发器配置细节 #

• 确认Auth控制台的「阻塞函数」设置中，选择的是正确的函数名称（注意大小写，函数名为createfirestoreuser）。
• 验证触发器的「事件类型」为「创建用户（before）」，避免选错事件类型。

4. 查看云函数日志 #

• 进入Firebase控制台「云函数」页面，找到createfirestoreuser函数，查看函数日志：
  • 若有报错（如权限不足、字段不存在），根据日志提示修复代码或权限。
  • 若完全无日志记录，说明触发器未触发，需重新检查配置与部署。

5. 代码优化与错误捕获 #

• 为避免静默失败，添加错误捕获和非空判断：

export const createfirestoreuser = identity.beforeUserCreated(async (event) => {
  try {
    const uid = event.data?.uid;
    if (!uid) {
      throw new Error("用户UID不存在");
    }
    await firestore.collection("users").doc(uid).create({
      id: uid,
      createdAt: admin.firestore.FieldValue.serverTimestamp()
    });
    console.log(`成功为用户${uid}创建Firestore文档`);
  } catch (error) {
    console.error("创建Firestore文档失败:", error);
    throw error; // 抛出错误会终止Auth操作，便于排查问题
  }
});

6. 重新测试触发器 #

• 创建新的测试用户，立即查看云函数日志确认是否触发。
• 若仍未触发，删除当前阻塞函数配置后重新添加，确保配置生效。

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