GCP Cloud Function提前终止致Firestore最后一次更新失效问题咨询

核心问题根源 #

你的问题本质是Cloud Functions函数实例过早终止，导致Firestore的写操作未能完全持久化到数据库。虽然你已经await了savePDF中的所有异步操作，但sendPDF函数里存在未被等待的异步任务，使得Promise.all提前完成并触发响应发送，函数随即进入终止流程，干扰了Firestore写操作的最终同步环节。

具体修复步骤 #

1. 修复sendPDF函数的异步等待

sendEmail是异步函数（返回Promise），但你当前没有await它的执行，导致sendPDF会立即返回已resolve的Promise，Promise.all会在邮件发送任务仍在运行时就完成，进而触发res.send终止函数。修改如下：

const sendPDF = async (pdf) => {
  if (!sendEmail) {
    sendEmail = require('../../utils/sendgrid').sendEmail
  }
  
  // 必须等待邮件发送任务完成
  await sendEmail({ /* config for sending the mail */})
}

2. 提前初始化Firestore客户端（优化冷启动场景）

在函数顶部提前初始化Firestore实例，避免冷启动时在savePDF中才创建客户端带来的延迟：

const admin = require('firebase-admin')
// ...其他依赖引入

// 初始化Firestore客户端
const db = admin.firestore();

// ...后续代码
// 在savePDF中使用db替代admin.firestore()
const docRef = db.collection('MyCollection').doc('DocID')

3. 确认Firestore更新参数的正确性

虽然延迟返回能生效说明参数本身无错误，但仍需确认requisitionFiles字段名与文档中的字段完全一致，避免拼写错误导致的更新无效果（比如大小写、下划线差异）。

为什么延迟返回能生效？ #

当你用setTimeout延迟发送响应时，函数实例不会立即终止，给了Firestore写操作足够的时间完成最终的同步与持久化，因此数据能正确写入数据库。但这只是临时 workaround，修复未等待的异步任务才是根本解决办法。

内容的提问来源于stack exchange，提问作者Rudi Ørnhøj