【Node】认识multer库

前言

在 Node.js 中处理文件上传是一个常见的需求，比如用户上传头像或文档。

那么，如何简单、安全地接收并保存这些文件呢？

本文说说 multer 的库，它可以帮助我们快速实现这一功能。

小问题：为什么使用 multer 而不是 Node.js 原生模块来处理文件上传。

🤔 补充知识：原生模块如何实现文件上传？

使用 Node.js 原生模块实现文件上传需要手动解析 multipart/form-data 格式的请求体，处理数据流并识别边界符。

然后逐个字段提取文件内容和元数据，最后通过 fs 模块将文件缓冲区写入磁盘，整个过程需要处理复杂的字节级操作和错误边界情况。

总之，比较麻烦！！

正文

什么是 Multer？

Multer 是一个 Node.js 中间件，专门用于处理 multipart/form-data 类型的表单数据（即文件上传）。

它基于 busboy 构建，可以高效地解析传入的请求，并将文件保存到服务器指定目录，同时提供对上传文件的元数据（如文件名、大小、类型）的访问。

🤔 补充知识： multipart/form-data 是啥类型？

multipart/form-data 是一种用于在 HTTP 请求中传输二进制数据（如文件）和文本数据混合内容的编码类型，它通过特定的边界分隔符将表单中的不同字段和数据分割成多个部分，每个部分可以独立设置内容类型和编码，使其能够同时高效传输文本字段和文件等二进制数据。

说人话，就是网页表单要同时上传"文字"和"文件"时用的格式。比如你填用户名（文字）又传头像（图片），浏览器就会把文字和图片打包成一个特殊包裹，里面用"分隔线"把不同内容隔开，服务器收到后知道哪里是文字、哪里是文件，分别处理。

Multer 用起来很简单：你只需配置文件存到哪、叫什么名，就能处理单个文件、多个文件甚至文字图片混传的情况，还能设置文件大小和类型限制，防止乱传文件。

基本用法

以下是一个基于 Express + js 的示例，演示如何使用 Multer 实现单文件上传：

安装 Multer

1npm install multer

创建 Express 服务并配置 Multer

1const express = require('express')
2const multer = require('multer')
3const app = express()
4
5/* 存储配置开始 */
6// 配置磁盘存储，也就是文件上传到服务器的目录
7const storage = multer.diskStorage({
8    destination: (req, file, cb) => {
9        cb(null, 'uploads/') // 文件保存目录
10    },
11    filename: (req, file, cb) => {
12        // 自定义文件名：时间戳+原文件名
13        cb(null, Date.now() + '-' + file.originalname)
14    }
15})
16/* 存储配置结束 */
17
18const upload = multer({storage})
19
20/* 上传路由开始 */
21// 处理单文件上传（字段名为 'avatar'）
22app.post('/upload', upload.single('avatar'), (req, res) => {
23    console.log(req.file) // 上传文件的信息
24    res.send('文件上传成功！')
25})
26/* 上传路由结束 */
27
28/* 服务启动开始 */
29app.listen(3000, () => {
30    console.log('服务运行在端口 3000')
31})
32/* 服务启动结束 */
33

运行测试
选 POST 方法
Body 选 form-data
key 那边输入 avatar，因为代码中写的是 upload.single('avatar')，然后同样在 key 的那边选择“file”，然后在 value 那边选择一个图片
点击发送，你会收到类似下面的结果，这就完成了 ✅️！！

1{
2    "fieldname": "avatar",
3    "originalname": "fufu.jpg",
4    "encoding": "7bit",
5    "mimetype": "image/jpeg",
6    "destination": "uploads/",
7    "filename": "1760977045699-fufu.jpg",
8    "path": "uploads\\1760977045699-fufu.jpg",
9    "size": 340363
10}
11

其他上传场景

多文件上传：

1app.post('/photos', upload.array('photos', 5), (req, res) => {  
2    console.log(req.files) // 文件数组  
3})

混合字段（文本+文件）：

1app.post('/submit', upload.fields([{name: 'avatar'}, {name: 'gallery'}]), (req, res) => {  
2    console.log(req.files) // 文件分组信息  
3    console.log(req.body) // 文本字段  
4})

最后

简单回顾下前言中的问题：

为什么选择 Multer 而不是 Node.js 原生模块？

因为原生模块（如 http 或 fs）需要手动解析复杂的 multipart 请求体，处理文件流和边界符，代码冗长且易出错。

Multer 做好了封装，开发者直接用 Multer 就可以了，省心方便。

《【Node】认识multer库》是转载文章，点击查看原文。