fs.writeFile保存图片异常：图片损坏问题排查求助

核心错误点 #

• 错误使用iconv-lite处理二进制图片：图片是纯二进制数据，不需要字符编码转换工具（iconv-lite仅用于文本编码转换），你的转换操作会破坏原始二进制结构，直接导致图片损坏。
• Content-Type设置无效：返回给客户端的Content-Type设为stream不符合HTTP规范，应该使用图片实际的MIME类型（比如文档里的image/png）。
• 冗余的base64循环转换：先将二进制转成base64再转回Buffer的操作完全多余，还可能引入数据失真。

修复后的代码 #

const { writeFile } = require('fs/promises');
const path = require('path');
const { ObjectId } = require('mongodb');

fastify.get('/gallery/:id', async (request, reply) => {
    const response = await gallery.findOne({ _id: ObjectId(request.params.id) });
    if (!response) {
        return reply.status(404).send('not found');
    }

    // 直接获取正确的图片Buffer
    let imageBuffer;
    // 针对MongoDB驱动返回的两种常见情况处理：
    if (response.file.data.buffer) {
        // 驱动已解析为Binary对象，直接取buffer属性
        imageBuffer = response.file.data.buffer;
    } else {
        // 驱动返回原始$binary结构，从base64转Buffer
        imageBuffer = Buffer.from(response.file.data.$binary.base64, 'base64');
    }

    // 保存图片到本地（用promise版避免回调嵌套）
    await writeFile(path.join(__dirname, '../uploads/', 'pic.png'), imageBuffer);
    console.log("The file has been saved!");

    // 设置正确响应头并返回图片
    reply.status(200)
         .header('Content-Type', response.file.mimetype)
         .send(imageBuffer);
});

关键说明 #

• 直接使用原始二进制数据：MongoDB存储的图片二进制数据，要么被驱动解析为带buffer属性的Binary对象，要么保留原始的$binary结构，两种情况都能直接转换为合法的Buffer，不需要经过iconv-lite处理。
• 匹配正确的Content-Type：返回图片时必须设置对应MIME类型，客户端才能正确识别并渲染图片。
• 优先用Promise版文件操作：fs/promises的writeFile更适合异步场景，避免回调嵌套和未捕获的异步错误。

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