Node.js Firebase云函数中PDF偶发无法保存是什么原因？

你的代码最大的问题是没有等待PDF生成、存储上传这些异步操作完成就提前结束了云函数的执行。Firebase 可调用函数（onCall）在async函数执行到末尾时，如果没有挂起的待等待Promise，会直接终止运行，不会等pdfDoc的end事件回调里的异步逻辑执行完，所以就出现偶尔存储成功、日志打不出来的不稳定现象。

具体的错误点包括：

• pdfkit的生成逻辑是基于事件回调的，你没有将它包装为Promise，所以async函数不会等待它的end事件触发就已经执行完毕
• 就算end事件触发，你调用的fileRef.save()和fileRef.makePublic()本身都是异步方法，你没有加await等待执行完成，这两个操作还没跑完云函数就被回收了
• 你在end事件回调里return的对象根本不会被作为可调用函数的返回值，因为回调是异步触发的，此时函数早就已经返回了

把PDF生成+上传的逻辑整体包装为Promise，然后主动等待所有异步操作完成再返回，替换你原来末尾PDF处理的代码即可：

const printer = new Printer(fontDescriptors);
const pdfDoc = printer.createPdfKitDocument(docDefinition);
const chunks = [];
const pdfName = `${teamId}/${incidentId}/report.pdf`;

// 把整个PDF生成+上传逻辑包装为Promise，方便等待执行完成
const pdfProcessPromise = new Promise((resolve, reject) => {
  pdfDoc.on('data', (chunk) => {
    chunks.push(chunk);
  });

  pdfDoc.on('end', async () => {
    try {
      functions.logger.log("PDF on end started");
      const result = Buffer.concat(chunks);
      const fileRef = bucket.file(
        pdfName,
        { metadata: { contentType: 'application/pdf' } }
      );
      // 等待存储操作全部执行完成
      await fileRef.save(result);
      await fileRef.makePublic();
      functions.logger.log("File generated and saved.");
      // 返回最终结果给前端
      resolve({ success: true, pdfPath: pdfName });
    } catch (err) {
      functions.logger.error("PDF存储失败：", err);
      reject(new functions.https.HttpsError('internal', 'PDF存储失败', err));
    }
  });

  pdfDoc.on('error', (err) => {
    functions.logger.error("PDF生成失败：", err);
    reject(new functions.https.HttpsError('internal', 'PDF生成失败', err));
  });
});

pdfDoc.end();
// 等待整个PDF流程执行完成再返回
return await pdfProcessPromise;

• 你原代码error事件里的res.status(501).send(err)是HTTP类型云函数的遗留代码，res变量根本没有定义，要直接删掉，用上述代码里的reject抛出错误即可，可调用函数会自动处理错误返回
• 云函数的临时目录os.tmpdir()是实例复用的，如果你有大量生成请求，最好在任务结束后删除下载的临时图片，避免临时目录占满导致后续请求出错

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