如何用Node.js、Express、MongoDB及GridFSBucket下载而非流式传输文件

完全可以通过GridFSBucket实现将MongoDB中的文件下载到用户本地设备的需求，不需要额外工具。你的现有代码已经用到了GridFSBucket，但当前的下载逻辑存在冲突，导致仅能流式加载图片而非触发本地下载，以下是问题分析和修正方案：

现有代码的问题 #

当前download函数同时执行了两个冲突操作：

• 将文件写入服务器本地（downloadStream.pipe(fs.createWriteStream('./' + req.params.name))）
• 将文件数据流式返回给客户端（downloadStream.on("data", ...)）

这种分流会导致流数据混乱，且未设置触发浏览器下载的响应头，因此浏览器只会直接显示图片而非触发本地保存。

修正后的下载函数 #

调整逻辑，直接将GridFS的下载流通过Express响应对象发送给客户端，并设置正确的响应头触发下载：

const download = async(req, res) => {
    try {
        await mongoClient.connect();
        const database = mongoClient.db(dbConfig.database);
        const bucket = new GridFSBucket(database, {
            bucketName: dbConfig.imgBucket,
        });

        // 查询目标文件的元信息
        const fileList = await bucket.find({ filename: req.params.name }).toArray();
        if (!fileList || fileList.length === 0) {
            return res.status(404).send({ message: "文件不存在！" });
        }
        const targetFile = fileList[0];

        // 设置响应头，触发浏览器下载
        res.setHeader('Content-Disposition', `attachment; filename="${decodeURIComponent(targetFile.filename)}"`);
        res.setHeader('Content-Type', targetFile.contentType || 'application/octet-stream');

        // 将GridFS下载流直接pipe到响应对象
        const downloadStream = bucket.openDownloadStreamByName(req.params.name);
        downloadStream.pipe(res)
            .on('error', (err) => {
                res.status(500).send({ message: `下载失败：${err.message}` });
            })
            .on('finish', () => {
                console.log('文件已成功发送给客户端');
            });
    } catch (error) {
        return res.status(500).send({
            message: error.message,
        });
    }
};

关键说明 #

1. 查询文件元信息：确保文件存在，同时获取文件的contentType，保证响应头类型正确
2. 设置响应头：
   • Content-Disposition: attachment：告诉浏览器将响应视为下载文件而非页面内容
   • filename：指定用户下载后看到的文件名，用decodeURIComponent处理特殊字符
3. 直接pipe到响应对象：GridFS的可读流可以直接对接Express的响应可写流，无需中间写入服务器本地，高效完成文件传输

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