使用Firebase Admin从云函数更新Firestore文档耗时超3分钟求助

核心问题排查方向 #

1. 未正确返回异步操作Promise（90%概率匹配你的现象） #

Firebase Functions要求所有异步操作必须向运行时返回对应的Promise，否则函数会认为代码执行完毕，提前冻结进程上下文，后续的.then/.catch回调只能等到函数实例超时（默认超时时间刚好为3分钟）解冻后才会执行，和你描述的耗时完全吻合。
你的代码没有返回usersRef.set对应的Promise，修复示例如下：

// 以HTTP函数为例
exports.updateUser = functions.https.onRequest((req, res) => {
  const userData = {
    firstName: "John",
    lastName: "Doe"
  }

  functions.logger.log("Updating user", userData)

  const usersRef = admin.firestore().collection("users").doc("1")
  // 重点：返回Promise给函数运行时
  return usersRef.set(userData, { merge: true })
        .then(() => {
              functions.logger.log("Success user updated!", userData)
              res.status(200).send("更新成功")
          })
        .catch((error) => {
              functions.logger.error("Error updating user!", error)
              res.status(500).send("更新失败")
          })
})

// async/await写法参考，函数标记async后会自动隐式返回Promise
exports.updateUserAsync = functions.https.onRequest(async (req, res) => {
  try {
    const userData = { firstName: "John", lastName: "Doe" }
    functions.logger.log("Updating user", userData)
    const usersRef = admin.firestore().collection("users").doc("1")
    await usersRef.set(userData, { merge: true })
    functions.logger.log("Success user updated!", userData)
    res.status(200).send("更新成功")
  } catch (error) {
    functions.logger.error("Error updating user!", error)
    res.status(500).send("更新失败")
  }
})

如果是其他触发类型的函数（例如Firestore触发、Pub/Sub触发），同样需要返回异步操作的Promise，不要遗漏return关键字。

2. 服务区域配置不匹配 #

• 确认Firestore数据库部署的区域和Admin SDK初始化时指定的region一致，避免跨区域请求导致的超长延迟
• 确认Cloud Function部署的区域和Firestore在同一区域，同区域内网调用延迟远低于跨区域调用

3. 网络配置异常 #

• 如果你给Cloud Function配置了VPC连接器，检查VPC出口规则是否允许访问Firestore服务，若配置了「所有流量走VPC」但VPC没有配置公网出口，会导致请求一直重试直到超时
• 检查项目的IAM权限，确认Function对应的服务账号有datastore.user权限，不会因为鉴权重试导致延迟

4. 效果验证 #

修复后可以在Firebase控制台查看函数的调用日志，对比请求执行耗时，如果耗时降到毫秒级，说明是Promise未返回的问题。

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