Node.js+Express中fs.createReadStream下载ZIP仅Firefox无法触发下载

我之前也碰到过一模一样的问题，Firefox Quantum对触发文件下载的响应头要求比Chrome、Safari要严格得多，你当前的代码确实遗漏了关键的响应头配置，导致浏览器没法识别这是一个需要下载的附件。

核心问题分析 #

仅设置Content-type只能告诉浏览器内容的格式，但没明确指令让它把内容作为附件下载——Firefox需要更清晰的“下载触发信号”，否则会默认把响应内容当成页面渲染数据处理，自然不会弹出下载提示。

修复步骤 #

你需要补充两个关键响应头，并优化一下错误和文件清理逻辑：

1. 添加Content-Disposition头：这是触发下载提示的核心，明确告诉浏览器把响应作为附件处理，同时指定用户下载后看到的默认文件名。
2. 添加Content-Length头：帮助Firefox确定文件总大小，避免因无法预估内容长度而跳过下载提示的情况。

修改后的完整代码示例：

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

// 假设这是你的/download路由处理函数
app.get('/download', (req, res) => {
  const pathToZip = './path/to/your/temp-file.zip'; // 替换为实际ZIP文件路径
  const downloadFileName = 'user-friendly-filename.zip'; // 用户下载时看到的文件名

  try {
    // 获取文件状态，用于获取文件大小
    const fileStats = fs.statSync(pathToZip);

    // 设置完整的响应头
    res.setHeader('Content-Type', 'application/zip');
    // 关键：指定为附件并设置文件名
    res.setHeader('Content-Disposition', `attachment; filename="${downloadFileName}"`);
    // 告诉浏览器文件总大小，优化下载体验
    res.setHeader('Content-Length', fileStats.size);

    const fileStream = fs.createReadStream(pathToZip);

    fileStream.pipe(res);

    fileStream.on('error', (error) => {
      // 错误处理：返回错误状态码并清理临时文件
      res.status(500).send('文件下载失败');
      console.error('读取ZIP文件出错:', error);
      fs.unlink(pathToZip, (unlinkErr) => unlinkErr && console.error('删除临时文件失败:', unlinkErr));
    });

    fileStream.on('close', () => {
      // 下载完成后删除服务器上的ZIP文件
      fs.unlink(pathToZip, (unlinkErr) => {
        if (unlinkErr) console.error('删除ZIP文件失败:', unlinkErr);
      });
      fileStream.destroy();
    });
  } catch (err) {
    res.status(404).send('ZIP文件不存在');
    console.error('获取文件信息出错:', err);
  }
});

额外注意事项 #

• 确保pathToZip变量在close事件里和创建流时的路径完全一致，避免误删其他文件。
• 如果你的ZIP是动态生成的临时文件，一定要确保文件完全写入磁盘后再创建读取流，否则会导致下载的ZIP损坏。
• 测试时可以在Firefox的网络面板里检查响应头，确认Content-Disposition和Content-Length是否正确返回。

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