Node.js使用multer中间件时Postman报Unexpected end of form错误

问题原因分析 #

这个错误本质是表单数据解析失败，结合你的代码来看，核心问题集中在两个方面：

1. 前端手动设置Content-Type破坏解析逻辑 #

使用axios发送FormData时，axios会自动生成包含boundary的正确Content-Type头（格式类似multipart/form-data; boundary=----WebKitFormBoundaryxxxx）。你手动设置的"Content-Type": "multipart/form-data; "丢失了关键的boundary参数，导致multer无法正确分割表单里的字段和文件。

2. Postman请求配置可能不符合要求 #

直接用Postman测试时，如果没有正确配置form-data请求体，也会触发该错误。

解决方案 #

1. 修复前端代码 #

删除手动设置的Content-Type头，让axios自动处理请求头：

const signUpHandler = async (e) => {
    e.preventDefault();
    const myForm = new FormData();

    myForm.append("name", name);
    myForm.append("email", email);
    myForm.append("password", password);
    myForm.append("file", file);

    if (!check) {
        alert("Enter all the fields carefully!");
    } else {
        try {
            dispatch(setLoading(true));
            const { data } = await axios.post(
                `${url}/register`,
                myForm
                // 移除手动设置的headers，axios会自动生成正确的Content-Type
            );
        } catch (e) {
            console.log(e);
        }
    }
};

2. 正确配置Postman请求 #

• 选择POST请求，填入正确的接口URL
• 切换到Body标签，选择form-data格式
• 添加以下字段：
  • name：类型选Text，填入对应值
  • email：类型选Text，填入对应值
  • password：类型选Text，填入对应值
  • file：类型选File，点击右侧按钮选择要上传的文件
• 确保file字段名和后端upload.single("file")中的参数完全一致

3. 后端额外检查（可选） #

• 确保项目根目录下的upload目录存在，若不存在手动创建（multer默认会尝试创建，但权限不足时可能失败）
• 可以配置multer的storage来更灵活控制文件存储，避免默认随机命名的问题：

import multer from "multer";

const storage = multer.diskStorage({
    destination: (req, file, cb) => {
        cb(null, "upload"); // 指定存储目录
    },
    filename: (req, file, cb) => {
        cb(null, file.originalname); // 保留原文件名
    }
});

const upload = multer({ storage });
router.route("/register").post(upload.single("file"), register);

4. 验证文件接收情况 #

在register函数中添加日志，确认文件是否被正确接收：

const register = (req, res) => {
    console.log("上传的文件信息：", req.file);
    // 后续业务逻辑
};

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