Node.js使用Multer上传文件至AWS S3报unexpected field错误

Multer抛出unexpected field错误，核心原因只有一个：上传请求里的文件字段和你后端Multer配置声明要接收的字段对不上。
你现在代码里写的是upload.single('file')，意思是这个接口只认字段名是file的单个文件，只要前端传FormData的时候，append文件用的键不是file（比如叫image、uploadFile、avatar），或是请求里多带了其他没声明要处理的文件字段，就会直接报这个错。

方案1：对齐前后端字段名（最常用） #

根据你的实际业务场景，把前后端的文件字段名统一即可：

• 如果你前端已经固定了文件字段名，比如实际传的是image，直接改后端single方法里的参数就行：

// 把'file'换成你前端实际传的字段名
app.post('/upload', upload.single('image'), async function (req, res, next) {
  res.send('Successfully uploaded ' + req.file.location + ' location!')
})

注意：字段名大小写敏感，必须完全一致，差一个字符都不行

• 如果你后端就想固定用file作为接收字段，直接改前端上传逻辑，确保FormData里append文件的键名是file，参考前端正确写法：

const formData = new FormData();
// 第一个参数必须和后端single()里的字符串完全一致
formData.append('file', 选中的文件对象);
// 调接口的时候不要手动设置Content-Type，让浏览器自动生成带boundary的multipart/form-data头
axios.post('http://localhost:3001/upload', formData)

方案2：不限制字段名接收 #

如果你不想限制前端传的文件字段名，直接把single换成any方法即可，支持接收任意字段的文件：

// 替换原来的upload.single('file')
app.post('/upload', upload.any(), async function (req, res, next) {
  // any模式下文件信息存在req.files数组中，取第一个就是上传的文件
  res.send('Successfully uploaded ' + req.files[0].location + ' location!')
})

风险提示：用upload.any()的时候一定要加文件类型、大小校验，避免被上传恶意文件。

如果确认字段名完全一致还是报错，检查这两个高频问题：

• 前端手动给请求加了Content-Type: multipart/form-data头：传FormData的时候不要手动设置这个头，浏览器会自动补上带boundary参数的正确头，手动设置会导致Multer解析失败，也会抛这个错
• 路由上重复挂载了其他Multer/文件解析中间件：同一个请求被多次解析文件，也会触发字段异常

内容的提问来源于stack exchange，提问作者Prashant Singh