MERN栈Multer上传图片至Cloudinary报MulterError Unexpected field错误

MulterError: Unexpected field 是Multer解析multipart/form-data请求时的典型报错，结合贴出的代码，触发原因有两个核心点：

• 中间件注册逻辑错误：把Multer解析中间件upload.single('image')作为参数传入了asyncHandler包装函数，Express不会按预期执行这个文件解析中间件，解析流程异常就会抛出字段不匹配的错误。
• 请求字段名不匹配：如果修正中间件写法后还报这个错，本质是Postman里上传文件使用的字段key和代码里upload.single('image')指定的image不一致，比如把文件字段key写成了img、productImg、file，或者额外传了其他未被Multer规则声明的文件字段，Multer遇到未预期的文件字段就会直接抛错。

1. 修正中间件挂载逻辑
   不要把Multer中间件塞到业务处理函数的asyncHandler包装里，正确的做法是在路由定义时按「Multer解析中间件 -> 业务逻辑处理函数」的顺序注册：

// 路由文件里的写法示例
const express = require('express')
const router = express.Router()
const upload = require('../config/multer-config') // 对应项目中multer配置文件的实际路径
const { createProduct } = require('../controllers/productController')

router.post('/', upload.single('image'), createProduct)

修正后的createProduct业务函数去掉嵌套的Multer调用，同时补上缺失的文件存在校验、图片地址存储逻辑：

// @desc     Create product
// @route    POST /api/products
// @access   Private
const createProduct = asyncHandler(async(req, res) => {
    // 补上文件存在校验
    if(!req.body.name || !req.body.price || !req.body.quantity || !req.body.description || !req.file){
        throw new Error('Please add all fields including product image')
    }
    // 上传图片到cloudinary
    const result = await cloudinary.uploader.upload(req.file.path);

    // 创建新商品记录
    const product = await Product.create({
        name: req.body.name,
        price: req.body.price,
        quantity:  req.body.quantity,
        description: req.body.description,
        image_url: result.secure_url, // 原代码漏存图片可访问地址，前端无法正常展示图片
        cloudinary_id: result.public_id
    })

    res.status(200).json(product) // 原代码返回cloudinary原始响应，调整为返回数据库创建的商品数据
})

2. 校准Postman请求配置

• 请求体选择form-data格式，不要使用x-www-form-urlencoded、raw等其他格式
• 文件上传项的key必须严格填写image，和upload.single()的参数完全一致，大小写不能有偏差，该项的类型下拉选择File后再选择本地图片文件
• 其余文本字段（name、price、quantity、description）正常填写键值对即可，不要添加多余的文件类型字段

3. 可选扩展：如果后续需要支持多图上传，把upload.single('image')换成upload.array('image', 允许的最大文件数量)即可，对应Postman里同key传多个文件就能正常解析。

内容的提问来源于stack exchange，提问作者Ope Afolabi