Joi嵌套文档校验错误仅在终端显示未返回Postman问题排查

Postman无法获取Joi具体校验错误、仅返回固定"message": "Error adding pack"的问题和数据结构是否嵌套无关，是3处代码错误共同导致的：

• 路由未挂载校验中间件：packRoutes.js中POST接口的处理链仅配置了addPack控制器，完全没有引入编写好的packValidation中间件，请求默认不会进入Joi校验流程。非嵌套的部门接口能正常返回校验错误，核心原因就是对应路由正确挂载了校验中间件。
• 校验层代码存在空值读取风险+Joi嵌套语法错误：pack.validator.js中直接读取req.body.packDetail.packNumber属性，一旦请求体未传入packDetail字段，会直接抛出Cannot read properties of undefined类型错误，无法进入Joi校验的错误返回分支，错误直接抛到上层控制器被catch块捕获，仅在终端打印日志、返回固定错误文案；同时Joi规则定义时嵌套对象没有用joi.object()包裹，校验规则本身不生效。
• Mongoose Schema存在拼写错误：pack.js中jobDescription字段的必填配置写为require: true，正确属性名为required: true，会导致MongoDB写入时抛出Schema校验错误，同样被catch块兜底返回固定文案。

1. 路由层挂载校验中间件 #

修改packRoutes.js的POST路由配置，将校验中间件加入处理链，注意中间件顺序要放在控制器前面：

// 原有引入代码不变
const router = express.Router();

router.get("/", getPacks);
router.get("/:id", getPack);
// 新增packValidation中间件
router.post("/", packValidation, addPack);
// PATCH接口如果需要校验也按相同方式添加
router.patch("/:id", packValidation, updatePack);
router.delete("/:id", deletePack);

module.exports = router;

2. 重写Joi校验逻辑 #

修复嵌套语法、补全异常捕获，去掉手动拼接payload的冗余逻辑，避免空值读取报错：

const joi = require("joi");
const errorFunction = require("../../utils/errorFunction");

// 嵌套对象必须用joi.object()包裹定义规则
const validation = joi.object({
  packDetail: joi.object({
    packNumber: joi.string().alphanum().min(6).max(6).trim(true).required(),
    jobDescription: joi.string().min(5).max(100).trim(true).required(),
  }).required()
});

const packValidation = async (req, res, next) => {
  try {
    // 直接传入req.body做校验，不需要手动解构字段，避免空值报错
    // 配置abortEarly: false可以一次性返回所有校验错误，不用逐次调试
    const { error } = validation.validate(req.body, { abortEarly: false });
    if (error) {
      res.status(406);
      return res.json(
        errorFunction(true, `Error in pack data : ${error.message}`)
      );
    }
    next();
  } catch (err) {
    res.status(400);
    return res.json(errorFunction(true, `Validation failed: ${err.message}`))
  }
};

module.exports = packValidation;

3. 修复Mongoose Schema拼写错误 #

修改pack.js中jobDescription字段的配置，补全required的拼写：

jobDescription: {
  type: String,
  required: true, // 修正原代码的拼写错误：require -> required
  trim: true,
  minlength: 5,
  maxlength: 100,
},

4. 优化控制器错误返回（调试用） #

修改pack.controller.js的catch块，临时返回具体错误信息方便排查问题，生产环境可以按需屏蔽敏感错误详情：

catch (error) {
  res.status(400);
  console.log(error);
  // 替换原固定错误文案，返回实际错误信息
  return res.json(errorFunction(true, `Error adding pack: ${error.message}`));
}

修复验证：传参不符合规则时，请求会在Joi校验层直接返回406状态码和具体错误详情，不会进入控制器逻辑；MongoDB层抛出的错误也会返回具体信息，不再只显示固定的"Error adding pack"。

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