Node.js 文件上传终极对比：Multer vs Formidable，性能差距竟达 3 倍！

Immerse

发布于 2025-09-17 13:58:08

10800

代码可运行

文章被收录于专栏：沉浸式趣谈沉浸式趣谈

运行总次数：0

代码可运行

大家好，我是 Immerse，一名独立开发者、内容创作者、AGI实践者。

• 关注公众号：#沉浸式趣谈，获取最新文章（更多内容只在公众号更新)
• 个人网站：https://yaolifeng.com 也同步更新。
• 转载请在文章开头注明出处和版权信息。

我会在这里分享关于编程、独立开发、AI、出海、个人思考等内容。

如果本文对你有帮助，欢迎动动小手指一键三连(点赞、评论、转发)，给我一些支持和鼓励，谢谢！

Node.js 文件上传的两大主流方案：Multer 和 Formidable 对比

Multer vs Formidable：谁更适合你的项目？

Multer：Express 的御用搭档

Multer 就像是 Express 框架的专属管家，专门负责处理 multipart/form-data 格式的文件上传。它基于 busboy 构建，最大的优势就是使用简单，3 行代码就能搞定基础上传功能。

核心特点：

• 简单易用：配置简单，上手快速
• Express 深度集成：与 Express 中间件完美配合
• 自动文件管理：自动处理文件命名和存储路径
• 内置安全限制：默认 200MB 文件大小限制

适用场景：

• Express 项目中的简单文件上传
• 头像、文档等小文件上传
• 快速原型开发
• 团队技术栈相对简单的项目

Formidable：高性能全能选手

Formidable 更像是一个专业的文件处理专家，不仅支持 Express，还能在 Koa、原生 Node.js 等各种环境中使用。最厉害的是它的性能：在基准测试中达到了 2566 MB/秒 的处理速度！

核心特点：

• 超高性能：处理速度是普通方案的 3-5 倍
• 框架无关：支持 Express、Koa、原生 Node.js
• 功能丰富：支持流式处理、插件扩展
• 久经考验：被 Transloadit 等大型服务验证

适用场景：

• 大文件上传处理
• 高并发文件上传需求
• 多框架项目
• 对性能要求严苛的生产环境

实战配置：关键参数设置避免踩坑

Multer 最佳实践配置

const multer = require('multer');
const path = require('path');

const storage = multer.diskStorage({
    destination: function (req, file, cb) {
        cb(null, 'uploads/'); // 确保目录存在
    },
    filename: function (req, file, cb) {
        // 生成唯一文件名，避免冲突
        cb(null, Date.now() + '-' + Math.round(Math.random() * 1e9) + path.extname(file.originalname));
    },
});

const upload = multer({
    storage: storage,
    limits: {
        fileSize: 10 * 1024 * 1024, // 10MB 限制
        files: 5, // 最多5个文件
    },
    fileFilter: (req, file, cb) => {
        // 只允许图片上传
        if (file.mimetype.startsWith('image/')) {
            cb(null, true);
        } else {
            cb(new Error('只允许上传图片文件！'), false);
        }
    },
});

Formidable 关键配置

const formidable = require('formidable');

const form = formidable({
    uploadDir: './uploads',
    keepExtensions: true, // 保留文件扩展名
    maxFileSize: 50 * 1024 * 1024, // 50MB
    maxFiles: 10, // 最多10个文件
    maxTotalFileSize: 100 * 1024 * 1024, // 总大小限制
    filter: function ({ name, originalFilename, mimetype }) {
        // 过滤不安全的文件类型
        return mimetype && mimetype.includes('image');
    },
});

配置要点解析：

• 文件大小限制：防止用户上传超大文件导致服务器崩溃
• 文件数量控制：避免批量上传攻击
• 类型过滤：只允许安全的文件类型
• 唯一命名：防止文件名冲突覆盖

性能与安全：数据说话

性能基准对比

根据实际测试数据：

• Multer：适中性能，大约 500-800 MB/秒
• Formidable：高性能，最高可达 2566 MB/秒

这意味着如果你需要处理大量文件上传，Formidable 的性能优势非常明显。一个 100MB 的视频文件，Formidable 可以在几秒内处理完成，而 Multer 可能需要更长时间。

安全防护要点

必须设置的安全参数：

1. 文件大小限制：防止 DoS 攻击
2. 文件类型检查：阻止可执行文件上传
3. 上传目录隔离：不要放在 web 根目录下
4. 文件名过滤：防止路径遍历攻击

错误处理示例：

// Multer 错误处理
app.use((err, req, res, next) => {
    if (err instanceof multer.MulterError) {
        if (err.code === 'LIMIT_FILE_SIZE') {
            return res.status(400).json({ error: '文件太大了！' });
        }
    }
    next(err);
});