表单上传PDF时遇Uploaddb验证失败：file字段为必填项

核心问题分析 #

错误Error: Uploaddb validation failed: file: Path 'file' is required说明你的Mongoose模型要求file字段必填，但后端接收表单数据时，该字段未被正确传递或解析。

分步排查与修复 #

1. 确认HTML表单的enctype属性 #

上传文件的表单必须指定enctype="multipart/form-data"，否则浏览器无法正确编码文件数据：

<form action="/upload" method="POST" enctype="multipart/form-data">
  <input type="text" name="name" placeholder="姓名">
  <input type="email" name="email" placeholder="邮箱">
  <input type="file" name="file" accept=".pdf"> <!-- name属性需与后端完全一致 -->
  <button type="submit">提交</button>
</form>

2. 配置Express文件上传中间件（multer） #

Express默认无法处理multipart/form-data请求，必须使用multer中间件解析文件：
先安装multer：

npm install multer

再在app.js中配置存储规则：

const multer = require('multer');
// 配置文件存储路径与命名规则
const storage = multer.diskStorage({
  destination: (req, file, cb) => {
    cb(null, './uploads'); // 确保uploads文件夹已手动创建
  },
  filename: (req, file, cb) => {
    cb(null, Date.now() + '-' + file.originalname);
  }
});
const upload = multer({ storage: storage });

3. 确保路由使用正确的multer中间件 #

处理上传的路由需使用upload.single('file')（对应单文件上传），且字段名要与HTML表单的name="file"完全匹配：

app.post('/upload', upload.single('file'), async (req, res) => {
  try {
    // 先检查文件是否被正确解析
    if (!req.file) {
      return res.status(400).send('请选择要上传的PDF文件');
    }
    // 创建Uploaddb文档，将文件路径赋值给file字段
    const uploadData = new Uploaddb({
      name: req.body.name,
      email: req.body.email,
      file: req.file.path // 此处需与Schema定义的file字段类型匹配
    });
    await uploadData.save();
    res.send('文件上传成功');
  } catch (err) {
    res.status(500).send(err.message);
  }
});

4. 检查Mongoose Schema的file字段定义 #

确认Schema中file字段的配置符合实际存储需求，比如存储文件路径时用字符串类型且必填：

const mongoose = require('mongoose');
const UploaddbSchema = new mongoose.Schema({
  name: { type: String, required: true },
  email: { type: String, required: true },
  file: { type: String, required: true } // 若存储二进制数据则用Buffer类型
});
module.exports = mongoose.model('Uploaddb', UploaddbSchema);

5. 验证请求数据 #

可在路由中打印调试信息，确认文件是否被正确解析：

console.log('解析后的文件:', req.file);
console.log('表单文本数据:', req.body);

如果req.file为undefined，说明multer配置或表单enctype存在问题；若req.file存在，再确认是否将其对应属性（如path）正确赋值给了Uploaddb的file字段。

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