调用Firebase V2 onCall云函数时出现FirebaseError: internal错误

我开发了一个React Native-Expo应用，使用firebase-functions/v2/https的onCall()实现了基础云函数，代码如下：

exports.addmessage = onCall((request) => {
    logger.info("Request: " + request.data.text);
    return {text: request.data.text}
});

函数部署后看似正常，但客户端App组件调用时返回Function call failed及[FirebaseError: internal]错误。客户端调用代码：

export default function App() {
  const addmessage = httpsCallable(functions, 'addmessage');
  
  function callFunction() {
    addmessage({ text: "Hello world!" })
      .then((result) => {
        console.log("Function called");
        console.log(result);
      }).catch((error) => {
        console.log("Function call failed");
        console.log(error)
      });
  }

  return (
    <SafeAreaProvider>
      <SafeAreaView style={styles.container}>
        <Button title="Call cloud function" onPress={() => callFunction()}></Button>
        <StatusBar style="auto" />
      </SafeAreaView>
    </SafeAreaProvider>
  );
}

已确认Firebase控制台日志无报错，onRequest函数能正常运行。项目依赖：客户端firebase@9.22.1（测试过9.20.0），函数端firebase-admin@11.8.0、firebase-functions@4.3.1。

• 检查云函数区域与客户端配置匹配
  云函数部署默认使用us-central1区域，若客户端未指定对应区域，会导致调用失败。确认客户端functions实例的区域设置与函数部署区域一致：

  import { getFunctions, httpsCallable } from "firebase/functions";
  const functions = getFunctions(app, 'us-central1'); // 替换为你的函数实际部署区域
  

• 为云函数添加错误捕获与明确返回
  当前函数未处理参数缺失等异常，会返回模糊的internal错误。修改函数添加错误处理逻辑：

  exports.addmessage = onCall((request) => {
    try {
      const text = request.data.text;
      if (!text) {
        throw new functions.https.HttpsError('invalid-argument', '必须传入text参数');
      }
      logger.info("Request: " + text);
      return {text: text};
    } catch (error) {
      logger.error("处理请求出错:", error);
      throw error;
    }
  });
  

  这样能返回明确的错误类型，便于定位问题。

• 查看云函数详细执行日志
  控制台日志可能遗漏初始化或执行阶段的细节，通过Firebase CLI命令查看完整日志：

  firebase functions:log --function addmessage
  

  检查是否存在函数初始化失败（如admin SDK配置错误）或执行时的隐性异常。

• 验证客户端Firebase初始化完整性
  确认客户端已正确初始化Firebase App，包含所有必要配置（apiKey、authDomain、projectId等），且functions实例基于已初始化的App创建。

• 排查网络环境问题
  Expo模拟器或真机可能存在代理、防火墙限制，导致无法访问Firebase函数域名。尝试关闭代理，或使用expo start --tunnel启动项目测试网络连通性。

• 更新Firebase CLI并重新部署函数
  CLI版本与函数依赖不兼容也可能引发问题，升级到最新稳定版后重新部署：

  npm install -g firebase-tools
  firebase deploy --only functions
  

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