使用Multer+Express多文件分文件夹上传时遇Unexpected field错误求助

问题描述 #

使用Multer和Express实现两个文件分别上传至videos和imagenes文件夹时，始终抛出MulterError: Unexpected field at wrappedFileFilter错误。单独使用updateVideo或updateImage中间件时错误依然存在，目标文件夹已提前创建。

错误原因分析 #

1. 配置项大小写错误：multer.js中updateVideo的配置项写为Storage（大写S），但Multer的正确配置项是小写的storage，导致自定义存储配置未生效，Multer使用默认内存存储，引发字段验证失败。
2. 中间件使用方式错误：路由中连续使用两个.single()中间件，第一个中间件会解析完整的请求体，第二个中间件无法找到未被解析的目标字段，从而抛出Unexpected field错误。
3. 路径拼接不规范：使用path.join(__dirname + 'videos')的写法错误，path.join的参数应分开传递，否则可能生成无效路径（如xxxvideos而非xxx/videos）。
4. 文件名生成逻辑错误：用path.extname(file.fieldname)获取扩展名，会取字段名的后缀（如字段名video对应.video），而非原文件的真实扩展名，导致文件名不符合预期。

修正后的代码实现 #

multer.js #

const multer = require('multer');
const path = require('path');

// 统一存储配置，根据字段名区分存储路径
const storage = multer.diskStorage({
    destination: (req, file, cb) => {
        const folder = file.fieldname === 'video' ? 'videos' : 'imagenes';
        // 正确拼接路径
        const ruta = path.join(__dirname, folder);
        cb(null, ruta);
    },
    filename: (req, file, cb) => {
        // 获取原文件的真实扩展名
        const ext = path.extname(file.originalname);
        // 生成唯一文件名
        const nombre = Date.now() + ext;
        cb(null, nombre);
    }
});

// 使用.fields处理多个文件字段，每个字段限制上传1个文件
const uploadFiles = multer({ storage: storage }).fields([
    { name: 'video', maxCount: 1 },
    { name: 'imagen', maxCount: 1 }
]);

module.exports = {
    uploadFiles
}

router.js #

const express = require('express');
const router = express.Router();
const { uploadFiles } = require('./multer');

router.get('/',(req,res) => {
 res.render('index');
});

// 使用单个中间件处理多文件上传
router.post('/subir', uploadFiles, (req,res) =>{
    // 上传的文件信息会保存在req.files中，可按需处理
    console.log('上传文件信息:', req.files);
    res.send('文件上传成功！')
});

module.exports = router;

其他文件说明 #

• index.js无需修改，保持原有配置即可。
• index.ejs的表单配置正确，无需调整。

内容的提问来源于stack exchange，提问作者Axel Roni Torrico Arnez