Firebase NodeJS SDK设置自定义声明失败：无对应用户记录

核心问题分析 #

你遇到的FirebaseAuthError: There is no user record corresponding to the provided identifier错误，大概率由以下原因导致：

1. Admin SDK与客户端SDK所属Firebase项目不匹配 #

前端客户端SDK连接的Firebase项目，和后端Admin SDK初始化使用的服务账号密钥所属项目不一致，导致Admin在错误的项目中查找用户，自然找不到客户端创建的用户记录。

2. 用户创建后的系统同步延迟 #

客户端调用createUserWithEmailAndPassword成功后，Firebase Auth系统可能需要极短时间完成跨节点同步，若此时立即调用Admin SDK的setCustomUserClaims，可能因数据未同步完成导致找不到用户。

3. UID传递的格式异常 #

虽然你确认UID已传递，但FormData在解析过程中可能出现字符串截断、转义等问题，导致后端拿到的UID与实际用户UID不一致。

分步解决方案 #

方案1：验证项目一致性 #

检查Firebase配置的匹配性：

• 前端客户端config对象中的projectId，必须和后端Admin SDK使用的服务账号密钥文件里的project_id完全一致。
• 确认后端process.env.PATH_TO_KEY指向的是当前项目的服务账号密钥JSON文件（可在Firebase控制台→项目设置→服务账号→生成新私钥下载）。

方案2：添加用户校验与重试机制 #

在设置自定义声明前，先通过Admin SDK查询用户是否存在，若不存在则重试几次以处理同步延迟：

// 替换原有的auth.setCustomUserClaims代码段
const setClaimsWithRetry = async (uid, claims, retries = 3) => {
  try {
    // 先校验用户是否存在
    await auth.getUser(uid);
    await auth.setCustomUserClaims(uid, claims);
    console.log("Custom claims set for user");
    response_200(res, "Successfully created new user in DB");
  } catch (error) {
    if (error.code === "auth/user-not-found" && retries > 0) {
      // 延迟1秒后重试
      await new Promise(resolve => setTimeout(resolve, 1000));
      return setClaimsWithRetry(uid, claims, retries - 1);
    }
    console.error("Error setting custom claims:", error);
    response_500(res, "Failed to set custom claims");
  }
};

// 调用重试函数
setClaimsWithRetry(uid, { role: "user" });

方案3：确认UID传递准确性 #

在前后端分别添加日志，验证传递的UID是否一致：

• 前端新增日志：

formData.append("uid", user.uid);
console.log("Sending UID:", user.uid); // 打印发送的UID
fetch(...)

• 后端新增日志：

router.post("/register", filesUpload, async (req, res) => {
  try {
    const { name, email, phone, uid } = req.body;
    console.log("Received UID:", uid); // 打印接收的UID
    // ... 其余代码
  } catch (err) {
    // ... 错误处理
  }
});

方案4：优化身份验证逻辑（推荐） #

不要直接传递UID到后端，改用客户端生成的ID Token，后端通过验证Token获取真实UID，避免伪造风险同时确保项目匹配：

• 前端修改：

// 替换formData.append("uid", user.uid);
const idToken = await user.getIdToken();
formData.append("idToken", idToken);

• 后端修改：

// 替换原有的const { uid } = req.body;
const { idToken } = req.body;
const decodedToken = await auth.verifyIdToken(idToken);
const uid = decodedToken.uid;

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