Node.js（Express）中使用Json2csv实现CSV自动下载问题

我明白你已经搞定了JSON转CSV的格式转换，现在就差让用户点击API时自动触发output.csv的下载了。其实核心就是给响应头加上强制下载的标识，不用绕弯子写本地文件（除非你需要持久化存储），直接把生成的CSV内容返回给客户端就行。

先看看修正后的完整代码：

const { Json2csvParser } = require('json2csv'); // 确保正确导入模块

const JsonToCsv = (fields, res, data) => {
  const opts = { fields };
  try {
    const parser = new Json2csvParser(opts);
    const csv = parser.parse(data);

    // 设置触发下载的关键响应头
    res.setHeader('Content-Type', 'text/csv');
    res.setHeader(
      'Content-Disposition',
      'attachment; filename="output.csv"' // 这里指定下载的文件名
    );

    // 直接把CSV内容发送给客户端
    res.send(csv);
  } catch (err) {
    // 处理转换过程中的错误，返回500状态码
    res.status(500).json({ error: err.message });
  }
};

// 示例调用（假设是Express路由）
app.get('/download-csv', (req, res) => {
  const sampleData = [
    { name: 'Alice', age: 30 },
    { name: 'Bob', age: 25 }
  ];
  const fields = ['name', 'age']; // 你要导出的字段
  JsonToCsv(fields, res, sampleData);
});

关键说明： #

• Content-Disposition头：这是让浏览器识别为下载文件的核心，attachment表示以附件形式下载，filename指定下载后的文件名。
• 不需要fs.write：如果你的需求只是让用户下载，直接把生成的CSV字符串通过res.send()返回即可，写入本地文件属于额外操作，反而会增加服务器开销。
• 错误处理：一定要捕获转换过程中的异常（比如字段不匹配、数据格式错误），避免API崩溃。

如果之前你用fs.write是为了备份文件，可以在res.send(csv)之后再执行写入操作，但不要让写入文件的过程阻塞响应返回。

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