Firebase Cloud Functions OnCall返回Null，请求排查解决方案

问题概况 #

Firebase Cloud Functions的OnCall函数调用后返回Null，仅OnCall函数出现此问题，OnRequest函数运行正常，Firebase依赖版本为"firebase": "9.17.1"。函数按目录拆分存储，scheduleOperation函数存于./appointment目录，主functions/index.js中导入该函数。

相关代码片段 #

前端调用代码 #

const schedule = () => {
    const functions = getFunctions(getApp());
    const scheduleAppointment = httpsCallable(functions, "scheduleOperation");
    scheduleAppointment({ text: "messageText" })
      .then((result) => {
        console.log(result.data);
      })
      .catch((error) => {
        console.error(error);
      });
  };

./appointment目录中的函数代码 #

const functions = require("firebase-functions");
const admin = require("firebase-admin");
const url = require("url");
const cors = require("cors")({ origin: true });
var serviceAccount = require("../serviceAccountKey.json");

exports.scheduleOperation = functions.https.onCall((data, context) => {
  return{
    data: {
      firstNumber: "First",
    }; // 此处存在语法错误
});

主functions/index.js代码 #

//----------------------//
// The Index function which calls Schedule operation->
//----------------------//
const { scheduleOperation } = require("./appointment");
const client = new Client({});
exports.scheduleOperation = functions.https.onCall((data, context) => {
  scheduleOperation(data, context, client); // 未返回调用结果
});

预期与实际结果 #

• 预期返回：

{
    data: {
      firstNumber: "First"
    }
}

• 实际接收：Null

排查思路 #

• 主函数未返回值：主index.js中的exports.scheduleOperation调用子函数后没有return语句，函数默认返回undefined，OnCall会将其转为null返回前端。修复方式：添加return，即return scheduleOperation(data, context, client);。
• 子函数语法错误：./appointment中的函数返回对象时，firstNumber字段后误用分号，属于语法错误，会导致函数执行失败返回null。需修正为：

  return {
    data: {
      firstNumber: "First"
    }
  };
  

• 参数不匹配：主函数调用子函数时传入了3个参数，但子函数仅定义了2个参数，需调整子函数参数定义以接收client，或修改主函数调用逻辑。
• 检查部署状态：确认最新代码已部署到Firebase，避免本地修改未同步云端导致旧代码运行。
• 查看函数日志：登录Firebase控制台进入Functions日志页面，检查是否有语法错误、未捕获异常等报错信息，这类异常会导致OnCall函数返回null。

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