Express.js res.download下载后删本地文件提前执行问题解决

rmSync 同步删除方法不是触发该问题的原因，就算替换为异步删除方法rm，放在当前的回调位置依然会出现下载刚启动就删除文件的问题。

问题根源是res.download()的回调触发时机不符合预期：该方法的回调会在响应头发送完成、本地文件流成功挂载到响应流、准备开始向客户端传输数据时触发，根本不会等待客户端接收完所有文件数据，这就是删除操作提前执行的核心原因。

之前用固定时长setTimeout延迟删除的方案本质是赌文件传输耗时，遇到大文件、弱网场景必然失效，没有通用性。

要准确捕获客户端完整接收文件的时机，需要监听Node.js原生响应对象的finish事件：该事件是HTTP模块标准定义的触发点，仅当所有响应数据都被写入系统网络缓冲区、确认向客户端发送完成时才会触发，完全匹配「下载完成后删除」的需求。

参考实现代码：

res.download(filePath, (err) => {
  if (err) {
    return next(err)
  }

  // 正常传输完成时触发删除
  res.on('finish', () => {
    if (AUTO_DELETE_ENABLED) {
      rmSync(filePath)
      console.log('下载完成，已删除本地源文件')
    }
  })

  // 兜底：传输中途断连/用户取消下载时，也清理残留文件
  res.on('close', () => {
    if (AUTO_DELETE_ENABLED && !res.writableEnded) {
      try {
        rmSync(filePath)
        console.log('传输中断，已清理残留文件')
      } catch (delErr) {
        console.error('文件删除失败:', delErr)
      }
    }
  })
})

• 上述实现同时覆盖了正常下载完成、传输中途异常断开两种场景，不会产生残留临时文件
• 如果业务对文件完整性要求极高，可以额外在前端侧增加文件哈希校验逻辑，下载完成后校验通过再发通知让服务端删除，但绝大多数普通下载场景下，监听finish事件已经是足够稳定的通用方案，鲁棒性远高于固定延迟逻辑
• 保留rmSync也不会影响逻辑正确性，删除操作本身耗时极短，不会阻塞事件循环造成明显性能问题，如果追求全异步写法，替换为fs.promises.rm加await即可，不影响核心触发逻辑。

内容的提问来源于stack exchange，提问作者m.js