Node.js Form-Data上传：如何先校验参数再上传文件

问题原因分析 #

1. 手动调用multer时req.body.userCode为undefined：
   multipart/form-data格式的请求需要multer来解析，直接在路由里处理时，请求还没经过multer解析，所以req.body是空对象，自然拿不到userCode。

2. multer作为中间件时文件先上传：
   默认的diskStorage会直接把文件保存到磁盘，中间件执行顺序是先处理文件上传，再执行你的校验逻辑，不符合先校验再上传的需求。

方案一：内存暂存+校验后写入磁盘 #

先用multer的内存存储解析整个表单（包括文本字段和文件），校验userCode通过后，再把内存中的文件写入磁盘。

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

// 用内存存储暂存文件，不直接写到磁盘
const memoryStorage = multer.memoryStorage();
const upload = multer({ storage: memoryStorage });

app.post('/uploadimage', upload.single('file'), function (req, res) {
    // 注意：字段名要和前端FormData里的key一致，你之前写的userID需改成userCode
    const userCode = req.body.userCode;
    console.log("用户编码:", userCode);

    checkUserField(userCode, config.number, (err, userData) => {
        if (err) {
            // 校验失败，直接返回错误，内存中的文件会自动释放
            return res.status(500).json({ message: err });
        }

        // 校验通过，将内存中的文件写入磁盘
        const savePath = path.join(__dirname, './images/', req.file.originalname);
        fs.writeFile(savePath, req.file.buffer, (writeErr) => {
            if (writeErr) {
                return res.status(500).json({ message: '文件保存失败' });
            }
            const fileUrl = `/images/${req.file.originalname}`; // 根据实际访问路径调整
            res.send('Image Upload:' + fileUrl);
        });
    });
});

方案二：利用multer的fileFilter前置校验 #

multer的fileFilter函数会在处理文件上传前触发，此时文本字段已经被解析，可以在这里完成userCode校验，校验不通过则直接拒绝文件上传。

const multer = require('multer');

const storage = multer.diskStorage({
    destination: function (req, file, cb) {
        cb(null, './images/');
    },
    filename: function (req, file, cb) {
        cb(null, file.originalname);
    },
});

// 自定义文件过滤器，前置校验userCode
const fileFilter = (req, file, cb) => {
    const userCode = req.body.userCode;
    checkUserField(userCode, config.number, (err) => {
        if (err) {
            // 校验失败，拒绝文件上传
            cb(new Error(err), false);
        } else {
            // 校验通过，允许上传文件
            cb(null, true);
        }
    });
};

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

app.post('/uploadimage', upload.single('file'), function (req, res) {
    // 走到这里说明校验通过且文件已上传完成
    const fileUrl = `/images/${req.file.originalname}`;
    res.send('Image Upload:' + fileUrl);
});

注意事项 #

• 确保前端FormData中的字段名和后端一致：如果前端传的是userCode，后端就不要写成userID；
• 方案一中要注意内存占用：如果上传大文件，内存存储可能导致内存溢出，适合小文件场景；方案二更适合大文件场景，因为校验不通过就不会接收文件内容。

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