Firebase onCall云函数.then回调内返回值为null如何解决

Firebase 可调用类型云函数（onCall 触发类型）的核心规则是：必须把异步操作的 Promise 链整体返回给函数外层，云函数才会等待异步操作执行完成，再把最终结果返回给客户端。

你遇到的返回null问题本质是Promise链断裂：

• 你在 .then() 回调里（位置a）写的return，只是把值返回给了Promise链内部，没有把整个admin.auth().createUser()开头的Promise返回给最外层的onCall回调，云函数不会等这个异步操作跑完就直接结束执行，自然拿不到a位置的返回值。
• 你在位置b写return能生效，是因为那是同步执行的代码，云函数启动时就会立刻执行返回，但这时候用户创建逻辑还没执行完，返回的结果根本不是创建用户完成后的预期内容。

正确写法1：Promise 链式返回 #

只需要在整个Promise链前加return，把Promise抛给外层的onCall处理即可：

exports.createUser = functions.https.onCall((data, context) => {
  // 直接return整个Promise链，不要在外面包无catch的空try块，同步try捕获不到异步错误
  return admin.auth().createUser({
    email: "kevin3928@gmail.com",
    password: "a3tbmz"
  }).then((userRecord) => {
    // 此处为用户创建完成后的逻辑，return的内容会作为最终结果返回给客户端
    const resultList = [/* 填入你需要返回的指定列表内容 */];
    return resultList;
  }).catch((error) => {
    // 按onCall规范抛出可识别的错误
    throw new functions.https.HttpsError('internal', '创建用户失败', error.message);
  });
});

正确写法2：async/await 写法（解决解析错误） #

你遇到的Parsing error: Unexpected token =>解析错误，90%以上由两个原因导致：

1. 你的Cloud Functions运行时选择了Node 8及更早版本，这类旧版本不支持async/await语法，需要在项目根目录package.json里把Node引擎版本改成16或更高（Firebase目前推荐最低运行时为Node 18）：

{
  "engines": {
    "node": "18"
  }
}

2. 项目的ESLint配置没有开启ES2017及以上语法支持，在.eslintrc.js等对应配置文件里，把parserOptions的ecmaVersion设为8及以上即可。

配置修复完成后，async/await的正确代码如下：

exports.createUser = functions.https.onCall(async (data, context) => {
  try {
    const userRecord = await admin.auth().createUser({
      email: "kevin3928@gmail.com",
      password: "a3tbmz"
    });
    // 用户创建完成后再组装要返回的列表
    const resultList = [/* 填入你需要返回的指定列表内容 */];
    return resultList;
  } catch (error) {
    throw new functions.https.HttpsError('internal', '创建用户失败', error.message);
  }
});

避坑提醒 #

• 不要在异步Promise外面套没有catch的空try/catch，同步try/catch捕获不到微任务队列里的Promise异步错误，要么在Promise链末尾加.catch()，要么配合async/await把await逻辑放在try块内。
• 可调用云函数不要返回undefined、null这类无意义值，所有正常分支都要有明确的return值，错误分支要抛出符合规范的HttpsError，否则客户端会收到不可识别的内部错误。
• 示例代码里硬编码邮箱密码的写法仅适合本地测试，上线前要改成从data参数读取客户端传入的用户参数，同时补充参数校验、权限校验逻辑。

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