如何本地调试Firebase Auth的beforeUserCreated阻塞函数

我完全理解你想要在本地调试Firebase Auth的beforeUserCreated阻塞函数的需求，结合你已经尝试的操作，我给你梳理下完整的步骤和需要注意的细节：

一、配置firebase.json关联阻塞函数 #

首先要在项目根目录的firebase.json中，给Auth模拟器添加preauth配置，指定你的beforeUserCreated处理器文件路径，具体配置如下：

{
  "emulators": {
    "auth": {
      "port": 9099,
      "preauth": {
        "disable_warnings": true,
        "metadata": {
          "providers": [
            {
              "uid": "custom",
              "displayName": "Custom Auth Emulator",
              "createRequestProcessor": "./functions/beforeUserCreated.js"
            }
          ]
        }
      }
    }
  }
}

注意createRequestProcessor的路径要和你的函数文件位置对应，确保相对路径正确。

二、修正beforeUserCreated函数的写法 #

你当前的函数有几个需要调整的点，才能正常生效：

1. 用户对象里的邮箱字段是user.email，不是user.emails
2. 阻塞函数要阻止用户创建时，需要返回包含错误信息的对象，而不是仅打印日志
3. 本地调试时初始化admin最好指定项目ID，避免凭证缺失问题

修正后的示例代码：

const admin = require("firebase-admin");
// 本地调试显式指定项目ID，解决凭证缺失问题
admin.initializeApp({ projectId: "你的测试项目ID" });

exports.beforeUserCreated = async (user) => {
  // 校验邮箱域名
  if (!user.email?.endsWith("@example.com")) {
    console.error("用户邮箱域名不符合要求");
    // 返回错误信息，阻止用户创建
    return {
      error: {
        message: "仅允许example.com域名的邮箱注册",
        code: 403
      }
    };
  }
  console.log("用户邮箱验证通过，允许创建");
  // 返回null表示允许用户创建
  return null;
};

module.exports = exports;

三、启动模拟器并测试 #

1. 确保你已经全局安装Firebase CLI，且本地项目已通过firebase init完成初始化
2. 启动Auth模拟器：

firebase emulators:start --only auth

3. 用curl或者Postman调用本地注册接口测试，示例curl命令：

curl -X POST http://localhost:9099/identitytoolkit.googleapis.com/v1/accounts:signUp?key=fake-api-key \
  -H "Content-Type: application/json" \
  -d '{
    "email": "test@example.com",
    "password": "Test123456!"
  }'

本地模拟器不需要真实API密钥，key可以填任意字符串（比如fake-api-key）。

四、解决「缺少项目凭证」的问题 #

你提到调用接口时遇到凭证缺失错误，核心原因是admin初始化时未指定项目ID，解决方式二选一：

• 在admin.initializeApp中显式传入你的Firebase项目ID
• 在本地设置环境变量GOOGLE_CLOUD_PROJECT=你的测试项目ID

备注：内容来源于stack exchange，提问作者Estevao Santiago