Node.js中使用formidable处理文件上传错误的问题求助

你的代码存在几个关键问题，导致错误处理失效：

1. 错误处理顺序颠倒 #

当文件大小超限等错误发生时，form.parse的回调会先触发err，此时files可能未被正确初始化。你先判断!files.uploaded会导致报错，而且错过对err的及时处理。

2. Promise未正确处理错误 #

你创建的Promise只在成功时调用resolve，但错误场景下没有调用reject，会导致请求一直处于挂起状态，客户端得不到响应。

3. 控制台输出参数搞反 #

你把minFileSize和maxFileSize的输出写反了，导致日志信息错误。

4. 缺少文件类型校验逻辑 #

你没有实现文件类型的校验，需要添加对应逻辑来限制允许上传的文件类型。

修复后的完整代码 #

app.post('/putdata', async (req, res) => {
    // 定义允许的文件MIME类型
    const allowedMimeTypes = ['image/jpeg', 'image/png', 'application/pdf'];
    const form = new formidable.IncomingForm({
        maxFileSize: 1 * 1024 * 1024, // 1MB
        minFileSize: 1, // 最小1字节
    });

    // 修正控制台输出的参数顺序
    console.log('Min file size allowed : ' + form.options.minFileSize);
    console.log('Max file size allowed : ' + form.options.maxFileSize);

    try {
        const { fields, files } = await new Promise((resolve, reject) => {
            form.parse(req, (err, fields, files) => {
                // 优先处理formidable抛出的错误（比如大小超限）
                if (err) {
                    reject(err);
                    return;
                }
                resolve({ fields, files });
            });
        });

        // 处理未选择文件的情况
        if (!files.uploaded) {
            res.status(400).send('未选择上传文件');
            return;
        }

        const uploadedFile = files.uploaded;

        // 校验文件类型
        if (!allowedMimeTypes.includes(uploadedFile.mimetype)) {
            res.status(400).send(`不允许的文件类型，仅支持${allowedMimeTypes.join(', ')}`);
            return;
        }

        // 这里执行文件上传后的逻辑，比如移动文件到指定目录
        // fs.renameSync(uploadedFile.filepath, './uploads/' + uploadedFile.originalFilename);

        res.status(200).send('文件上传成功');
    } catch (err) {
        // 处理formidable抛出的错误，比如大小超限
        if (err.code === 'LIMIT_FILE_SIZE') {
            res.status(400).send('文件大小超出限制，最大允许1MB');
        } else {
            res.status(500).send('上传失败：' + err.message);
        }
    }
});

关键修复点说明 #

• 错误处理优先级：先通过Promise捕获formidable的原生错误（如大小超限），再处理业务逻辑错误（如未选文件、类型不符）。
• Promise正确封装：将form.parse正确包裹在Promise中，错误时调用reject，成功时调用resolve，配合try/catch统一处理异常。
• 文件类型校验：通过allowedMimeTypes数组定义允许的类型，校验上传文件的mimetype字段。
• 响应及时终止：每个错误场景返回响应后都用return终止后续逻辑，避免重复响应。

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