随着 Web 应用程序的普及，文件上传成为了 Web 开发过程中的重要部分。HTML 提供了简单的文件上传表单，但是处理上传文件的方式却各不相同。在 Node.js 中，可以使用不同的库和框架来处理文件上传，但是不同的实践会有不同的性能和安全问题。本文将介绍 Node.js 中处理文件上传的最佳实践，并给出示例代码。
安装依赖库
在 Node.js 中，处理上传文件需要使用中间件，其中最受欢迎的中间件是 multer 和 formidable。这些中间件都具有处理文件上传的基本功能，但是它们的实现方式有所不同。在本文中，我们将使用 multer 这个中间件，因为它在处理文件上传时更加灵活和易于使用，同时它也比 formidable 更受欢迎。
npm install --save multer
使用 Multer 处理文件上传
使用 multer 处理文件上传的方式很简单。首先，需要将 multer 导入到文件中：
const multer = require('multer');
const upload = multer({ dest: 'uploads/' });在这个例子中，我们使用了 multer 自带的 dest 配置，指定应该将上传的文件存储在哪个文件夹中。这个文件夹必须事先存在，否则会失败。
接下来，我们需要将上传的文件添加到路由或控制器中：
app.post('/upload', upload.single('file'), function (req, res, next) {
// 处理文件上传后的逻辑
});在这个例子中，我们将上传的文件赋予了一个 file 的字段名。这意味着，上传表单中的文件字段必须是 file 才能被正确处理。
最后，需要在处理上传文件的函数中使用 req.file 来获得上传的文件信息：
let file = req.file; console.log(file.originalname); console.log(file.path);
在这个例子中，我们输出上传的文件的原始文件名和文件在服务器上的路径。
限制文件上传的大小和类型
当处理文件上传时，最好限制文件的大小和文件类型。这有助于避免服务器被攻击，同时还可以更好地管理上传的文件。
在 multer 中，限制文件大小和文件类型有两种方法：
使用 limits 选项限制文件大小
在上传文件时，加入 limits 选项可以限制上传文件的大小。例如，下面的代码限制了上传文件不能超过 1MB：
const upload = multer({
dest: 'uploads/',
limits: { fileSize: 1000000 }
});使用 fileFilter 方法限制文件类型
使用 fileFilter 方法可以限制上传文件的类型，例如只允许上传图片，或只允许上传 PDF 文件。下面的代码演示了如何只允许上传 JPEG 或 PNG 格式的图片：
-- -------------------- ---- -------
----- ------ - --------
----- -----------
----------- -------- ----- ----- --- -
-- ----------------------------------------------- -
------ ------ ----------- ----- ----- --- ------------
-
-------- ------
-
---在这个例子中，我们使用了正则表达式检查上传的文件是否为 JPEG 或 PNG 图片。如果文件类型不匹配，则返回错误信息，否则继续上传。
使用 Multer 处理多个文件上传
当处理多个文件上传时，需要使用 array 函数，如下所示：
const upload = multer({ dest: 'uploads/' });
app.post('/upload', upload.array('files', 2), function (req, res, next) {
// 处理上传逻辑
});在这个例子中，我们将 upload.single 替换为了 upload.array，并将文件字段名替换为了 files。这意味着我们可以夹带多份文件。
在处理多个上传文件时，我们可以使用 req.files 属性来获取所有上传的文件的信息：
let files = req.files;
files.forEach(function (file) {
console.log(file.originalname);
});在这个例子中，我们循环遍历了所有上传的文件，并输出了它们的原始文件名。
使用 Multer 处理表单字段和文件一起上传
有时，需要在上传文件的同时上传表单字段，例如用户信息等。在 Multer 中，可以使用 fields 函数来实现这个需求。
首先，需要为表单字段创建一个对象，其中字段名作为键，而需要上传的文件数作为值：
const upload = multer({
dest: 'uploads/',
});
let uploadFields = [
{ name: 'avatar', maxCount: 1 },
{ name: 'gallery', maxCount: 8 }
];在这个例子中，我们为表单中的 avatar 字段和 gallery 字段分别指定了上传文件的数量限制。
接下来，可以使用 upload.fields 函数处理同时上传表单和文件的请求：
app.post('/upload', upload.fields(uploadFields), function (req, res, next) {
// 处理上传逻辑
});在这个例子中，我们使用 upload.fields 函数来处理多个上传字段。我们将上传字段对象传递给 upload.fields 函数，以确保我们仅下传我们所期望的字段。
在处理上传的同时上传表单字段时，我们可以使用 req.body 属性来获得表单字段的值：
let username = req.body.username; let avatar = req.files.avatar[0]; let gallery = req.files.gallery;
在这个例子中，我们分别获得了表单字段的 username 值，上传文件的 avatar 值和 gallery 值。
结论
本文介绍了 Node.js 中处理文件上传的最佳实践。我们使用 multer 中间件来处理文件上传，并介绍了如何限制文件大小和文件类型，以及如何处理多个文件上传和表单字段和文件一起上传。Node.js 中处理文件上传不仅仅只是使用 multer，还需要对不同的实践进行比较和选择。通过多练习，可以更好地了解和运用文件上传的最佳实践。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/67232f752e7021665e0ec24a