已部署的Firebase Function V2可调用函数返回404错误排查

问题根源 #

你客户端用的是Firebase Callable函数的调用方式（httpsCallable），但部署到云端的是普通HTTP Request函数，两者调用协议不兼容，导致404且无日志触发。

方案1：将云端函数改为Callable类型 #

把你的函数代码从普通HTTP函数改成Callable函数格式：

原来的普通HTTP函数（控制台显示Http Request类型）：

exports.cleantext = functions.https.onRequest((req, res) => {
  // 原处理逻辑
});

修改为Callable函数：

exports.cleantext = functions.https.onCall((data, context) => {
  // 处理逻辑示例：接收传入文本并清理
  if (!data.text) {
    throw new functions.https.HttpsError('invalid-argument', '需要传入text参数');
  }
  return { cleanedText: data.text.trim() };
});

重新部署函数后，客户端现有代码无需修改，httpsCallable会自动适配云端Callable函数的URL，调用即可正常触发。

方案2：客户端改用普通HTTP请求调用 #

如果不想修改云端函数，调整客户端代码，用普通HTTP请求替代httpsCallable：

async function callCleanText(inputText) {
  try {
    const response = await fetch('https://us-west1-project-name.cloudfunctions.net/cleantext', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({ text: inputText })
    });
    if (!response.ok) {
      throw new Error(`请求失败：${response.status}`);
    }
    const result = await response.json();
    return result;
  } catch (error) {
    console.error('调用出错：', error);
  }
}

注意：普通HTTP函数需自行处理跨域（CORS），若前端出现跨域错误，需在云端函数中添加CORS头：

res.set('Access-Control-Allow-Origin', '*');
res.set('Access-Control-Allow-Methods', 'POST, OPTIONS');
res.set('Access-Control-Allow-Headers', 'Content-Type');

额外检查项 #

• 确认函数部署区域与客户端设置的us-west1完全一致
• 确认云端函数名称与客户端调用的cleantext拼写、大小写完全匹配
• 方案1部署后，在Firebase控制台查看函数类型会显示为Callable

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