如何从ExpressJS返回Base64格式图片对象数组？

原代码的核心问题 #

1. 异步时序错误：fs.readdir和fs.readFile都是异步操作，你在遍历文件后立刻调用res.end(cardList)，此时所有文件还没读完，cardList根本没填充完成。
2. 响应格式错误：res.end()不能直接传入数组，必须转成JSON字符串；而且你设置的Content-Type: image/jpeg:base64完全错误，返回的是JSON数组，应该用application/json。
3. 错误处理失效：异步回调里的throw err无法被外层的try/catch捕获，因为回调函数的执行上下文和外层不同。
4. 未声明变量：cardList和cntr没有提前声明，会变成全局变量，并发请求时会出严重问题。

修正后的实现代码 #

用fs.promises的异步API配合async/await，逻辑更清晰，也能正确处理异步和错误：

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

data.getListOfImages = async function (req, res, next) {
  try {
    // 读取图片目录下的所有文件
    const files = await fs.readdir('./images/');
    // 过滤出JPEG文件（可选，避免读取非图片文件）
    const jpegFiles = files.filter(file => 
      file.toLowerCase().endsWith('.jpg') || file.toLowerCase().endsWith('.jpeg')
    );
    // 逐个读取文件并转Base64
    const cardList = await Promise.all(
      jpegFiles.map(async (file) => {
        const filePath = path.join('./images/', file);
        const base64Data = await fs.readFile(filePath, { encoding: 'base64' });
        // 返回对象，符合你要的Base64对象数组需求
        return {
          filename: file,
          base64: base64Data
        };
      })
    );
    // 返回JSON响应
    res.status(200).json({
      success: true,
      result: cardList
    });
  } catch (error) {
    logger.info("getListOfImages ==> Error while extracting image files : " + error);
    // 错误响应
    res.status(500).json({
      success: false,
      error: error.message
    });
    // 如果是Express中间件，传递错误给错误处理中间件
    next(error);
  }
};

关键改进点 #

• 使用fs.promises替代回调式API，配合async/await彻底解决异步时序问题。
• 用Promise.all并行处理文件读取，提升效率。
• 明确声明变量，避免全局污染。
• 正确设置响应的Content-Type（Express的res.json()会自动设置）。
• 错误处理统一在try/catch中，能捕获所有异步错误。
• 可选的JPEG文件过滤，避免读取无关文件。

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