Firestore JS客户端httpsCallable最大超时时间及超时报错咨询

问题详情 #

执行代码5分1秒后，持续遇到以下错误：

node:internal/process/promises:289
            triggerUncaughtException(err, true /* fromPromise */);
            ^

[FirebaseError: internal] {
  code: 'functions/internal',
  customData: undefined,
  details: undefined
}

Node.js v22.1.0

客户端代码如下：

export const app = initializeApp(firebaseConfig);
const functions = getFunctions(app, "us-central1");
connectFunctionsEmulator(functions, "127.0.0.1", 5001);
const testFunction = httpsCallable(functions, 'doTask', {timeout: 1200000})
testFunction({url: "url", vid: "test6"})
.then((result) => console.log(result))

目标函数需要10-15分钟才能执行完成，函数本身无报错且能成功运行，但客户端会崩溃。尝试让函数立即返回时客户端运行正常，现咨询Firebase JS客户端httpsCallable的最大超时时间。

核心结论 #

Firebase JS客户端的httpsCallable存在客户端层面的内置超时限制，即使手动设置更大的timeout参数，实际生效的上限是300秒（5分钟）——这就是你在5分1秒左右触发错误的原因。

原因说明 #

这个内置超时是Firebase SDK的设计限制，目的是避免客户端长时间挂起等待异步请求。虽然你在调用httpsCallable时传入了{timeout: 1200000}（20分钟），但SDK会强制截断超过300秒的超时设置，实际仍按5分钟超时处理。

解决方案建议 #

针对这种长时间运行的云函数，不适合用同步的httpsCallable等待结果，推荐以下两种方案：

• 异步任务模式：客户端调用云函数后，函数立即返回一个唯一任务ID；客户端后续通过轮询Firestore/实时数据库，或使用Firebase Cloud Messaging（FCM）接收任务完成的通知，再获取最终结果。
• 直接使用HTTP请求：绕过Firebase Functions的httpsCallable封装，用原生HTTP客户端（如fetch）发送请求，此时可以完全自定义超时时间。注意：Google Cloud Functions本身的最大运行时间是9分钟，超过会被平台强制终止，需确保你的函数运行时长在这个范围内。

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