Firebase模拟器中setCustomUserClaims执行无法结束问题排查

你的云函数无法正常结束，核心问题有两个：

• HTTP触发的云函数必须通过res对象发送响应（比如res.send/res.end），否则函数会一直处于挂起状态，直到超时被强制终止
• admin.auth().setCustomUserClaims是异步操作（返回Promise），你没有处理它的完成或失败状态，导致函数无法感知操作结束

修改后的代码（二选一即可） #

方式1：使用async/await（更直观） #

exports.addAdmin = functions.https.onRequest(async (req, res) => {
  try {
    await admin.auth().setCustomUserClaims("ZZyxFu17eN8y6orw0tSQ8Y0vyPFS", { admin: true });
    res.status(200).send("用户管理员权限设置成功");
  } catch (error) {
    console.error("设置权限失败:", error);
    res.status(500).send(`设置权限失败: ${error.message}`);
  }
});

方式2：使用Promise的then/catch #

exports.addAdmin = functions.https.onRequest((req, res) => {
  admin.auth().setCustomUserClaims("ZZyxFu17eN8y6orw0tSQ8Y0vyPFS", { admin: true })
    .then(() => {
      res.status(200).send("用户管理员权限设置成功");
    })
    .catch((error) => {
      console.error("设置权限失败:", error);
      res.status(500).send(`设置权限失败: ${error.message}`);
    });
});

关键说明 #

• 不管异步操作成功还是失败，都要调用res的方法结束请求，这样函数才能正常退出
• 处理错误可以避免未捕获的Promise异常，防止函数被意外杀死

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