轻松掌控 multer：Node.js 服务器文件上传指南

2023-12-17 21:33:05

multer 是一个基于 Express 的中间件，它可以方便地处理 multipart/form-data 类型的文件上传。在本文中，我将介绍如何使用 multer 来处理上传到 Node.js 服务器的文件。

安装 multer

首先，您需要安装 multer。您可以使用以下命令：

npm install multer

配置 multer

在安装了 multer 之后，您需要在您的 Express 应用中配置它。您可以使用以下代码：

const multer = require('multer');

const storage = multer.diskStorage({
  destination: './uploads/',
  filename: function (req, file, cb) {
    cb(null, Date.now() + '-' + file.originalname);
  }
});

const upload = multer({ storage: storage });

在上面的代码中，我们创建了一个 multer 实例，并指定了文件上传的存储位置。您还可以指定其他选项，例如允许上传的文件类型、最大文件大小等。

使用 multer 处理文件上传

在配置了 multer 之后，您就可以在您的 Express 路由中使用它来处理文件上传。您可以使用以下代码：

app.post('/upload', upload.single('file'), (req, res) => {
  res.json({
    success: true,
    file: req.file
  });
});

在上面的代码中，我们创建了一个 POST 路由，并使用了 multer.single('file') 中间件来处理文件上传。当用户提交文件时，multer 会自动将文件保存到指定的位置，并将文件信息存储在 req.file 对象中。

获取上传的文件

在处理了文件上传之后，您就可以使用 req.file 对象来获取上传的文件。您可以使用以下代码来获取上传的文件：

const file = req.file;

file 对象包含以下属性：

fieldname ：文件的字段名。
originalname ：文件的原始名称。
encoding ：文件的编码方式。
mimetype ：文件的 MIME 类型。
size ：文件的大小（以字节为单位）。
destination ：文件的存储位置。
filename ：文件在服务器上的名称。

存储上传的文件

在获取了上传的文件之后，您就可以将文件存储到您想要的位置。您可以使用以下代码来将文件存储到本地磁盘：

const fs = require('fs');

fs.writeFileSync('./uploads/' + file.filename, file.buffer);

在上面的代码中，我们将文件存储到了 uploads 目录下。您也可以将文件存储到其他位置，例如数据库或云存储。

响应上传请求

在存储了上传的文件之后，您就可以向用户响应上传请求。您可以使用以下代码来向用户响应上传请求：

res.json({
  success: true,
  file: req.file
});

在上面的代码中，我们将上传的文件信息返回给用户。

使用 multer 处理多个文件上传

如果您需要处理多个文件上传，您可以使用 multer.array() 或 multer.fields() 方法。

app.post('/upload', upload.array('files'), (req, res) => {
  res.json({
    success: true,
    files: req.files
  });
});

在上面的代码中，我们将使用 multer.array() 方法来处理多个文件上传。

使用 multer 处理文件上传的错误

在处理文件上传时，可能会发生一些错误。您可以使用 multer 的错误处理功能来捕获这些错误。

app.post('/upload', upload.single('file'), (req, res, next) => {
  const err = req.fileValidationError;
  if (err) {
    res.status(400).json({
      success: false,
      error: err
    });
    return;
  }

  res.json({
    success: true,
    file: req.file
  });
});