Mongoose配置Schema后POST写入MongoDB触发验证错误如何解决

你的接口GET、PATCH、DELETE能正常运行、仅POST写入失败是正常现象：GET是读操作不涉及校验，PATCH默认不会对更新操作跑全量Schema校验（除非手动开启runValidators: true），DELETE是删操作也不涉及新文档写入校验，只有POST新建文档时会对传入的所有字段执行你定义的全量Schema规则校验，只要有一个字段不符合规则就会抛错。

常见触发原因 #

• 必填字段漏传/格式不对
  你在Schema中标记了强制必填的字段有projectTitle、description、issueTitle三个，POST时只要这三个字段任意一个缺失、传值为null/undefined、传全空格字符串（你配置了trim: true，全空格trim后会变成空字符串），都会触发required校验失败。
• 枚举字段传值不匹配
  以下四个字段配置了严格枚举校验，传值必须和枚举列表完全匹配（区分大小写、不能多字少字），否则就会报错：
  • priority 仅支持传入 low、normal、important、critical
  • issuer 仅支持传入 Admin、Lead、QA
  • developer 仅支持传入 Jason W.、Ada L.、Alan T.
  • status 仅支持传入 open、closed
    比如传小写的admin、简写的Jason、首字母大写的Open都会校验失败。
• 字段长度超出限制
  projectTitle、issueTitle最大长度限制为30字符，description最大长度限制为120字符，传入内容长度超限也会抛错。

快速定位错误的方法 #

不用盲猜是哪个字段出问题，在POST接口的错误捕获逻辑里打印err.errors，就能拿到每个字段的具体校验失败原因：

// 接口示例
app.post('/api/issues', async (req, res) => {
  try {
    const issue = await Issue.create(req.body)
    res.status(201).json(issue)
  } catch (err) {
    // 打印具体错误详情，定位出问题的字段
    console.log('校验错误详情：', err.errors)
    res.status(400).json({ msg: err.message })
  }
})

容易忽略的隐性问题 #

• 先确认你的Express服务正确配置了express.json()中间件，否则POST请求体不会被解析，req.body为空的话所有必填字段都会缺失，必然报校验错。
• 检查前端传参的字段名是否和Schema完全一致，比如把issueTitle拼成issue_title、projectTitle拼成projectName的话，Mongoose识别不到对应字段，也会判定必填项缺失。
• 你Schema里createdAt的默认值写法有小问题，现在写的default: Date.now()会在Schema加载时就固定一个时间值，所有新创建的文档都会用同一个固定时间，改成default: Date.now（传函数引用，不要加括号调用），才能在每次新建文档时自动生成当前时间，这个问题不会触发校验错误，但会导致创建时间不准确。

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