Node.js+Express+MongoDB项目中如何将表格查询结果保存为文件

你现有逻辑已经完成了条件检索、数据传递到模板的流程，要把检索结果存文件，用Node.js内置fs模块完全可以实现，不需要额外依赖第三方包。先修复你原有代码的逻辑bug，再分两种常用场景实现存储/导出需求即可。

你当前写的getSyllabusesYear函数存在逻辑错误：MongoDB查询完成后没有把返回的结果赋值给模板变量，反而直接写死了空数组，会导致GET请求访问页面时表格无数据。修复后代码如下：

function getSyllabusesYear(req, res, next){
  Syllabus.find({}, function(err, yearsOfsyllabus){
    if (err) return next(err);
    // 原代码这里错误赋值为空数组，改为传入查询结果
    res.locals.yearsOfsyllabusList = yearsOfsyllabus;
    next();
  })
}

function postSyllabusesYear(req, res, next){
  const Year = req.body.yearCheck;
  Syllabus.find({
    yearOfsyl: Year
  }, function(err, yearsOfsyllabus){
    if (err) return next(err);
     res.locals.yearsOfsyllabusList = yearsOfsyllabus;
     next();
  });
}

如果需要每次检索后自动把结果存到服务器本地，按以下步骤修改：

1. 在路由文件头部引入Node内置模块，初始化存储目录

const fs = require('fs');
const path = require('path');
// 定义文件存储目录，这里设置为项目根目录下的syllabus_export文件夹
const SAVE_DIR = path.join(__dirname, 'syllabus_export');
// 服务启动时自动检查目录，不存在则创建
if (!fs.existsSync(SAVE_DIR)) {
  fs.mkdirSync(SAVE_DIR, { recursive: true });
}

2. 修改postSyllabusesYear函数，在拿到检索结果后增加写入文件的逻辑，支持存JSON或CSV两种常用格式：

function postSyllabusesYear(req, res, next){
  const Year = req.body.yearCheck;
  Syllabus.find({
    yearOfsyl: Year
  }, function(err, yearsOfsyllabus){
    if (err) return next(err);
    res.locals.yearsOfsyllabusList = yearsOfsyllabus;

    // ---------- 新增存储文件逻辑 ----------
    // 文件名带检索年份+时间戳，避免重名覆盖
    const fileName = `syllabus_${Year}_${Date.now()}`;

    // 可选1：存为JSON格式
    const jsonContent = JSON.stringify(yearsOfsyllabus, null, 2);
    fs.writeFile(path.join(SAVE_DIR, `${fileName}.json`), jsonContent, (writeErr) => {
      if (writeErr) return next(writeErr);
      // 写入完成后再走后续渲染逻辑
      next();
    });

    // 可选2：存为CSV格式（可直接用Excel打开，和JSON存储二选一即可）
    /*
    // 先拼CSV表头和内容
    const csvHeader = "Year,Name,Additional info\n";
    const csvContent = yearsOfsyllabus.map(item => {
      // 处理字段里的逗号、双引号，避免CSV格式错乱
      const name = `"${item.nameOfsyl.replace(/"/g, '""')}"`;
      const info = `"${item.syllabusInfo.replace(/"/g, '""')}"`;
      return `${item.yearOfsyl},${name},${info}`;
    }).join('\n');
    fs.writeFile(path.join(SAVE_DIR, `${fileName}.csv`), csvHeader + csvContent, (writeErr) => {
      if (writeErr) return next(writeErr);
      next();
    });
    */
  });
}

如果需要让用户主动触发下载，把检索到的结果存到用户自己的设备上，按以下步骤实现：

1. 修改table.ejs模板，在表格上方增加导出按钮，提交时携带当前检索的年份参数：

<!-- 在表格容器前加导出表单 -->
<form action="/syllabus/export" method="POST" class="mb-3">
  <input type="hidden" name="yearCheck" value="<%= yearOfsyllabusList[0]?.yearOfsyl || '' %>">
  <button type="submit" class="btn btn-primary">导出当前结果为CSV</button>
</form>

<!-- 原有表格代码保持不变 -->
<div class="container fixTable">
  <main>
  <!-- 原有表格渲染逻辑省略 -->
  </main>
</div>

2. 新增对应的导出路由处理函数，设置响应头触发浏览器下载：

function exportSyllabus(req, res, next) {
  const Year = req.body.yearCheck;
  Syllabus.find({ yearOfsyl: Year }, function(err, yearsOfsyllabus) {
    if (err) return next(err);
    // 设置响应头，告诉浏览器这是要下载的文件
    res.setHeader('Content-Type', 'text/csv; charset=utf-8');
    res.setHeader('Content-Disposition', `attachment; filename="syllabus_${Year}_${Date.now()}.csv"`);
    // 拼接CSV内容，开头加\uFEFF解决Excel打开中文乱码问题
    const csvHeader = "\uFEFFYear,Name,Additional info\n";
    const csvContent = yearsOfsyllabus.map(item => {
      const name = `"${item.nameOfsyl.replace(/"/g, '""')}"`;
      const info = `"${item.syllabusInfo.replace(/"/g, '""')}"`;
      return `${item.yearOfsyl},${name},${info}`;
    }).join('\n');
    // 直接返回CSV内容给浏览器触发下载
    res.send(csvHeader + csvContent);
  })
}

// 记得在路由配置里加对应的映射
// router.post('/syllabus/export', exportSyllabus);

• 如果单次要导出的数据量超过1万条，不要用fs.writeFile一次性写入，改用fs.createWriteStream流的方式写入，避免占用过高内存
• 存CSV时注意处理字段里的逗号、双引号，避免格式错乱，上述代码已经做了转义处理
• 如果需要导出.xlsx格式的Excel文件，再额外安装exceljs这类包即可，基础导出CSV用内置模块完全够用

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