Firebase Cloud Function持续返回INTERNAL ERROR 500如何解决

你遇到的500错误是云函数类型和写法不匹配导致的，和权限、业务逻辑无关：

• functions.https.onCall 是Firebase封装的可调用云函数，内置跨域处理、鉴权上下文解析能力，不需要手动引入cors包，也不接收express风格的(req, res)回调参数
• 你当前给onCall传入了req/res风格的回调，还手动调用cors、操作res对象返回响应，完全不符合onCall的运行规范，函数运行时无法按预期解析返回值，就会直接抛出INTERNAL ERROR 500。

根据你的客户端调用方式二选一即可：

方案1：客户端使用Firebase SDK调用（走onCall规范） #

删除cors相关逻辑，onCall的回调第一个参数是客户端传入的业务数据，第二个参数是请求上下文，直接返回需要下发给客户端的数据即可，不需要手动操作响应对象：

// Firebase config
const functions = require('firebase-functions');
const admin = require('firebase-admin');

admin.initializeApp();

exports.emailMessage = functions.https.onCall(async (data, context) => {
  console.log('客户端传入参数：', data);
  console.log('请求上下文（含鉴权信息）：', context);
  // 直接返回响应数据即可，框架会自动处理响应封装
  return { status: 'ok' };
});

注意：onCall类型函数抛出业务错误必须使用内置的functions.https.HttpsError，不要手动设置HTTP状态码返回

方案2：客户端用fetch/axios等原生HTTP方式调用（走普通HTTP函数规范） #

将onCall替换为onRequest，这时候才是标准的express风格请求处理逻辑，才需要手动处理cors：

// Firebase config
const functions = require('firebase-functions');
const admin = require('firebase-admin');
const cors = require("cors")({
  origin: true
});

admin.initializeApp();

exports.emailMessage = functions.https.onRequest((req, res) => {
  return cors(req, res, async() => {
    console.log('请求信息：', req);
    res.status(200).send({ status: 'ok' });
  }).catch(() => {
    res.status(500).send("error");
  });
});

• 代码修改后重新部署前，建议清空本地函数目录下的node_modules和依赖锁文件，重新执行npm install安装依赖后再部署，避免依赖版本和云函数运行时不兼容
• 不要只看客户端返回的500错误码，部署后直接去Firebase控制台的云函数日志面板查看运行时错误栈，能直接定位具体报错位置
• 如果你使用的是第二代Firebase云函数，导入路径替换为firebase-functions/v2/https即可，onCall和onRequest的写法规范和第一代一致

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