Firebase iOS SDK调用长耗时Cloud Function抛出DEADLINE EXCEEDED异常的排查与解决咨询

看起来你遇到了一个典型的「客户端先超时、服务端还在正常跑」的问题——明明Cloud Function能完整执行并在日志里输出结果，但iOS这边却先抛出了超时错误，而且调整Cloud Run的请求时长也没解决，我来帮你拆解下问题和解决办法：

首先，你得知道Firebase的HTTPS Callable有多层超时限制，你只改了Cloud Run的设置，但客户端和函数本身的超时可能还卡在默认值：

1. 最可能的根因：iOS SDK默认超时只有60秒 #

Firebase Functions iOS SDK的HTTPS Callable默认超时是60秒，这就意味着你的客户端在函数跑满2分钟之前，会在第60秒就主动放弃等待，抛出DEADLINE EXCEEDED错误，而此时你的Cloud Function还在后台正常执行，所以日志里完全看不到服务端错误。

解决这个问题很简单，只要在创建Callable实例时自定义超时时间就行，给你个Swift代码示例：

// 创建自定义配置，设置超时时间（比如300秒，也就是5分钟，足够覆盖你2分钟的函数耗时）
let callableOptions = HTTPSCallableOptions(timeout: 300)
// 用配置好的选项创建Callable函数
let askGeminiFunction = functions.httpsCallable("ask_gemini", options: callableOptions)
// 再执行调用
let result = try await askGeminiFunction.call(["prompt": prompt])

这里的timeout参数单位是秒，你可以根据函数的实际耗时调整，只要不超过服务端允许的最大超时就行。

2. 别漏了Cloud Function本身的超时设置 #

虽然你的函数能正常跑完，但还是要确认2nd gen Cloud Function的函数级别超时有没有设置足够长——这和Cloud Run的容器超时是两个独立的设置：

• 如果用Firebase CLI部署，可以在命令行加参数：firebase deploy --only functions:ask_gemini --timeout=300s
• 如果用firebase.json配置，可以在runtimeOptions里加timeoutSeconds字段：

  {
    "functions": [
      {
        "source": "functions",
        "codebase": "default",
        "runtimeOptions": {
          "timeoutSeconds": 300
        }
      }
    ]
  }
  

这个设置是限制函数本身的最大执行时长，必须大于等于你的函数实际耗时，否则服务端会提前终止函数。

3. 额外排查点：网络环境的隐性限制 #

如果上面两步改完还是有问题，可以排查下客户端的网络环境——比如某些公司WiFi、代理服务器会主动切断长时间未响应的HTTP连接。你可以换个测试网络（比如手机热点）试试，排除环境因素的影响。

总结下操作步骤 #

1. 先修改iOS客户端的Callable超时设置，把超时调到能覆盖函数实际执行时间；
2. 确认Cloud Function的函数级别超时也设置到位；
3. 测试修改后的调用，看是否能正常拿到结果。

之所以你在Google Logs Explorer里看不到错误，是因为服务端的函数根本没出错——错误是客户端主动超时断开连接导致的，完全是客户端侧的问题。

内容来源于stack exchange