本文档详细介绍了如何使用 Multer 中间件在 Node.js 应用中实现图片上传的大小和类型验证。通过配置 Multer 的 limits 和 fileFilter 选项，可以有效地控制上传文件的尺寸和格式，从而确保服务器接收到的图片符合预期要求，避免潜在的安全风险和资源浪费。同时，本文还提供了错误处理中间件，以便更好地向客户端反馈上传过程中的问题。
Multer 图片上传验证详解
在使用 Multer 处理文件上传时，对上传文件的大小和类型进行验证是至关重要的。这不仅可以提高应用程序的安全性，还能优化服务器资源的使用。以下将详细介绍如何使用 Multer 实现这些验证。
1. 配置 Multer 实例
首先，需要配置 Multer 实例，包括存储引擎、文件大小限制和文件类型过滤。
const multer = require("multer");
const path = require("path");
const shortid = require("shortid");
const diskStorage = multer.diskStorage({
destination: (req, file, cb) => {
cb(null, 'imagens');
},
filename: (req, file, cb) => {
cb(null, Date.now() + shortid.generate() + path.extname(file.originalname));
}
});
const upload = multer({
storage: diskStorage,
limits: {
fileSize: 1 * 1024 * 1024 // 1MB
},
fileFilter: (req, file, cb) => {
const acceptedExtensionsList = [".jpg", ".jpeg", ".png"];
const extname = path.extname(file.originalname).toLowerCase();
if (acceptedExtensionsList.includes(extname)) {
cb(null, true); // Accept the file
} else {
cb(new Error("Invalid file extension"));
}
}
});- storage: 定义了文件的存储方式。上面的例子使用了 diskStorage，将文件存储在服务器的 imagens 目录下，并使用 shortid 生成唯一的文件名。
- limits: 用于限制上传文件的大小。 fileSize: 1 * 1024 * 1024 表示限制文件大小为 1MB。
- fileFilter: 用于过滤上传的文件类型。 在这个例子中，只允许上传 .jpg、.jpeg 和 .png 格式的图片。path.extname(file.originalname).toLowerCase() 获取文件扩展名并转换为小写，然后检查是否在允许的扩展名列表中。如果文件类型不符合要求，则调用 cb(new Error("Invalid file extension")) 拒绝上传。
2. 使用 Multer 中间件处理上传请求
在路由处理函数中使用配置好的 Multer 中间件。
绿色大气办公家具类企业织梦模板1.0
下载
绿色大气办公家具类企业织梦模板是以织梦最新内核来进行开发的模板，该模板属于家具行业，装修企业，家装类，属于企业通用，装修设计、家具生产等企业均可以使用该模板，页面简洁简单，容易管理，DEDE5.5内核以上都可以使用；附带测试数据！模板特点：简洁美观大方小清新的设计风格，图片展示效果绝佳。页面结构简单，利于SEO的优化，模板后台易于管理。使用程序：织梦DEDECMS5.5以上版本都可以使用。温馨提示
router.post("/criarconta", upload.fields([{ name: "photos" }]), async (req, res) => {
var files = [];
if (req.files) {
files = req.files.photos;
}
if (files.length > 1) {
return res.status(400).json({ erro: "Não é permitido o upload de mais de 1 imagem!" });
}
let photos = [];
if (files && files.length > 0) {
files.forEach((photo, i) => {
photos[i] = photo.path;
});
}
return res.status(200).json({ erro: null, foto: photos });
});- upload.fields([{ name: "photos" }]) 指定了上传字段的名称。 这里表示接受名为 "photos" 的字段上传的文件。
3. 错误处理
为了更好地处理上传过程中可能出现的错误，例如文件大小超出限制或文件类型不符合要求，可以添加一个错误处理中间件。
const errorHandler = (err, req, res, next) => {
if (err instanceof multer.MulterError) {
// Multer error occurred (e.g., file size limit exceeded)
return res.status(400).json({ error: "File upload error: " + err.message });
} else if (err.code === "LIMIT_FILE_SIZE") {
// File size limit exceeded
return res.status(400).json({ error: "File size limit exceeded. Max file size is 1MB." });
} else {
// Other errors
return res.status(500).json({ error: "Internal server error" });
}
};
app.use(errorHandler); // 确保errorHandler在所有路由之后定义- 这个错误处理中间件会捕获 Multer 抛出的错误，并根据错误类型返回相应的错误信息。 例如，如果文件大小超出限制，会返回 "File size limit exceeded. Max file size is 1MB." 的错误信息。 如果文件类型不符合要求，会返回 "Invalid file extension" 的错误信息。
- 请确保将 errorHandler 中间件注册到应用程序中，并且在所有路由之后定义，以便能够捕获所有路由处理过程中可能发生的错误。
总结
通过配置 Multer 的 limits 和 fileFilter 选项，可以方便地实现文件大小和类型验证。添加错误处理中间件可以更好地向客户端反馈上传过程中出现的问题。 这些措施可以提高应用程序的安全性和用户体验。 记住，始终要对用户上传的文件进行验证，以防止潜在的安全风险。
