无法从Firebase Cloud Function提取自定义错误消息

你遇到的核心问题是：后端用了HTTP触发的云函数（onRequest），但前端用了Callable函数的调用方式（httpsCallableFromURL）。这两种云函数的响应格式规范不匹配，导致Callable客户端无法正确解析你返回的自定义错误信息，只能输出通用错误码和消息。

方案一：将后端改为Callable函数（推荐，适配前端现有调用方式） #

Callable函数（onCall）是Firebase专门为客户端SDK设计的调用模式，会自动处理错误的封装与解析。修改后端代码如下：

const functions = require("firebase-functions");

exports.verifyApp = functions.https.onCall((data, context) => {
  const { ref } = data; // Callable函数从data对象获取参数，而非URL query
  // 业务逻辑
  
  if (ref === "123") {
    return { message: "success" };
  }

  // 抛出符合Callable规范的错误，前端可直接获取自定义消息
  throw new functions.https.HttpsError(
    "invalid-argument",
    "ref not provided"
  );
});

前端调用同步修改（参数通过函数传入，而非URL拼接）：

import { getFunctions, httpsCallableFromURL } from "firebase/functions";

const verifyClaim = httpsCallableFromURL(
  getFunctions(),
  "http://localhost:5001/{placeholder}/us-central1/verifyApp"
);

verifyClaim({ ref: "23" })
  .then((result) => {
    console.log(result.data);
  })
  .catch((error) => {
    // 这里能正确拿到自定义的错误码和消息
    console.log(error.code, error.message);
  });

方案二：前端改用普通Fetch调用（保留后端onRequest结构） #

如果不想修改后端，前端直接用普通HTTP请求调用接口，就能直接解析响应中的自定义错误：

fetch("http://localhost:5001/{placeholder}/us-central1/verifyApp?ref=23")
  .then(async (response) => {
    if (!response.ok) {
      const errorData = await response.json();
      throw errorData;
    }
    return response.json();
  })
  .then((data) => {
    console.log(data);
  })
  .catch((error) => {
    // 直接获取自定义错误信息
    console.log(error.error, error.message);
  });

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