使用Multer与Postman上传图片时req.body.name未定义导致文件名异常问题排查

我来帮你搞定这个文件名变成undefined.jpg的问题！核心原因是req.body.name没有被正确获取到，下面分情况给你排查和解决：

1. 最常见的问题：Postman请求构造错误 #

你需要确保在Postman里正确构造multipart/form-data请求，这是最容易踩坑的地方：

• 切换到Body标签，选择form-data格式
• 添加两个字段：
  • 第一个字段key设为file，类型选择File，然后选择要上传的图片文件
  • 第二个字段key设为name，类型选择Text，输入你想要的文件名前缀（比如user_avatar_123）
• 注意字段名必须和代码完全匹配：文件字段是file（对应代码里的multer.single("file")），文本字段是name（对应req.body.name）

2. 验证请求体解析是否正常 #

Multer负责解析multipart/form-data类型的请求体，但如果你的Express应用没有正确配置基础中间件，可能导致req.body无法被填充。请确保你的主入口文件（比如app.js）里有这些配置：

const express = require('express');
const app = express();

// 解析普通表单数据，multipart数据由multer处理
app.use(express.urlencoded({ extended: true }));
app.use(express.json());

// 引入你的路由
const router = require('./router');
app.use('/api', router);

3. 给代码加容错逻辑，避免空值 #

即使前面的问题都解决了，也建议在upload.middleware.js里添加容错逻辑，防止出现undefined.jpg：

let storage = multer.diskStorage({
  destination: (req, file, cb) => {
    cb(null, __dirname + "/../client/public/uploads/profil");
  },
  filename: (req, file, cb) => {
    // 优先用req.body.name，没有的话就用文件原始名（去掉后缀）
    const fileName = req.body.name || file.originalname.split('.')[0];
    cb(null, `${fileName}.jpg`);
  },
});

4. 调试确认数据是否接收正确 #

你可以在upload.controller.js里加打印代码，确认req.body和req.file是否正确获取：

module.exports.upload = async (req, res) => {
  try {
    await uploadFile(req, res);

    // 调试用：打印请求体和文件信息
    console.log('接收的表单数据:', req.body);
    console.log('接收的文件信息:', req.file);

    if (req.file == undefined) {
      return res.status(400).send({ message: "请上传文件！" });
    }

    if (!req.body.name) {
      return res.status(400).send({ message: "请提供文件名！" });
    }

    res.status(200).send({
      message: "文件上传成功：" + req.body.name + ".jpg",
    });
  } catch (err) {
    const fileName = req.body.name || '未知文件';
    res.status(500).send({
      message: `上传失败：${fileName}.jpg. 错误信息：${err}`,
    });
  }
};

按照上面的步骤调整后，重新测试应该就能得到你想要的req.body.name + ".jpg"格式的文件名了。

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