Node.js 如何实现文件上传？

Question

Node.js 如何实现文件上传？

仓乃文 · Accepted Answer

Node.js 文件上传推荐使用 multer 中间件处理 multipart/form-data，支持单文件、多文件和字段校验。

基础单文件上传：
```javascript
const express = require("express");
const multer = require("multer");
const path = require("path");

const upload = multer({
  dest: "uploads/",           // 上传文件存储目录
  limits: { fileSize: 5 * 1024 * 1024 }  // 限制 5MB
});

const app = express();

app.post("/upload", upload.single("file"), (req, res) => {
  if (!req.file) return res.status(400).json({ error: "请选择文件" });
  res.json({
    filename: req.file.originalname,  // 原始文件名
    size: req.file.size,              // 文件大小
    path: req.file.path               // 存储路径
  });
});
```

自定义文件名和存储路径：
```javascript
const storage = multer.diskStorage({
  destination: (req, file, cb) => cb(null, "uploads/"),
  filename: (req, file, cb) => {
    const uniqueName = Date.now() + "-" + Math.round(Math.random() * 1E9);
    cb(null, uniqueName + path.extname(file.originalname));  // 保留扩展名
  }
});

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

多文件上传：
```javascript
// 最多 3 个文件，字段名为 photos
app.post("/upload-multi", upload.array("photos", 3), (req, res) => {
  res.json({ count: req.files.length });
});
```

补充说明：
- multer 只处理 multipart/form-data，普通 JSON 请求不经过 multer
- dest 和 storage 二选一，storage 可以自定义文件名
- limits 可以限制文件大小、数量等
- 生产环境建议上传到 OSS/CDN，不要直接存本地磁盘