Cloud Run/云函数发送响应后如何可靠清理/tmp临时文件

你当前的写法存在两个明显问题：

1. res.download()是异步非阻塞方法，调用后会立刻执行后面的fs.unlinkSync()，此时文件还没开始向用户传输，大概率会导致用户下载到损坏的空文件
2. Google Cloud Run 确实会在响应发送完成后随时冻结、甚至直接回收实例，写在响应流程外的后台代码没有执行保障，没法只靠"响应发完再删"的逻辑100%覆盖所有场景

你可以用两层兜底的方案处理临时文件，完全不会出现文件堆积占资源的问题：

第一层：请求级即时清理（覆盖99%正常场景） #

不要把删除逻辑写在res.download()调用之后，要把删除逻辑绑定到下载操作的完成/异常回调里，确保文件完全传输完成、或者传输失败中断后再执行删除，参考代码：

const fs = require('fs/promises');
const path = require('path');

// 文件处理完成后，把本次请求生成的所有临时文件（原始上传文件、中间文件、结果文件）路径统一归集
const tempFiles = [
  path.join(tempUploadDir, rawUploadFileName),
  path.join(tempUploadDir, middleProcessTempName),
  path.join(tempUploadDir, finalResultFileName)
];

res.download(finalResultFileName, async (err) => {
  // 无论下载成功还是失败，都执行临时文件删除
  await Promise.all(
    tempFiles.map(filePath => fs.unlink(filePath).catch(e => console.error(`删除临时文件${filePath}失败:`, e)))
  );
  if (err && !res.headersSent) {
    res.status(500).send('文件下载失败');
  }
});

注意：尽量不要用同步的fs.unlinkSync执行删除，会阻塞Node.js事件循环，影响同实例下其他并发请求的处理效率

第二层：实例级定时清理（兜住所有异常场景） #

针对请求异常断开、实例被强制中断导致请求级清理逻辑没执行的残留文件，直接在Express服务启动时加一个定时巡检任务，定期扫描临时目录，删除创建时间超过你业务最长处理时长的过期文件即可。Cloud Run单个实例的最长存活时间可配置上限为1小时，你只要把文件过期阈值设得比最长请求处理时间长（比如设为1小时，绝对不会误删正在处理中的文件）就不会出问题，参考代码：

const TEMP_UPLOAD_DIR = path.join(__dirname, 'temp_upload');
const SCAN_INTERVAL = 10 * 60 * 1000; // 每10分钟扫描一次临时目录
const FILE_EXPIRE_THRESHOLD = 60 * 60 * 1000; // 创建时间超过1小时的文件直接删除

// 服务启动即开启巡检任务
setInterval(async () => {
  try {
    const allFiles = await fs.readdir(TEMP_UPLOAD_DIR);
    for (const file of allFiles) {
      const filePath = path.join(TEMP_UPLOAD_DIR, file);
      const fileStat = await fs.stat(filePath);
      if (Date.now() - fileStat.birthtimeMs > FILE_EXPIRE_THRESHOLD) {
        await fs.unlink(filePath).catch(e => console.error(`清理过期文件${filePath}失败:`, e));
      }
    }
  } catch (e) {
    console.error('临时目录巡检异常:', e);
  }
}, SCAN_INTERVAL);

补充说明 #

Cloud Run的实例文件系统是临时隔离的，实例被回收时整个文件系统会直接销毁，不会出现跨实例的文件残留，不需要担心文件永久占用磁盘。上面两层方案结合，既不会影响用户正常下载文件，也完全不会出现临时文件堆积占满内存/磁盘的问题。

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