如何获取Express-validator报Invalid Value错误的具体原因？

默认配置下Express-validator校验失败时返回通用Invalid Value提示，且常规错误提取逻辑只会返回字段、值、错误类型三个基础信息，可通过以下方法拿到具体失败原因：

• 首先输出全量原始错误对象，不要提前做格式化过滤
  多数开发者排查时只会提取错误的msg/path/value三个字段，遗漏了其他携带根因的属性。排查阶段先打印完整错误数组：

  const checkResult = validationResult(req);
  if (!checkResult.isEmpty()) {
    // 输出所有错误的全量字段，不要提前做格式转换
    console.log(checkResult.array({ onlyFirstError: false }));
    return res.status(400).json({ errors: checkResult.array() });
  }
  

  v6及以上版本的错误对象中，location字段会标记参数来源（body/query/params等），如果是自定义校验、清理器（sanitizer）触发的错误，还会携带nestedErrors字段存具体的失败栈信息。
• 开启内置debug日志查看完整校验链路
  Express-validator内部依赖debug模块输出全量执行日志，启动服务时注入对应环境变量即可看到每一条校验规则的执行过程、入参、失败原因：
  • Mac/Linux 环境：DEBUG=express-validator:* node 你的服务入口文件.js
  • Windows CMD环境：set DEBUG=express-validator:* && node 你的服务入口文件.js
  • Windows PowerShell环境：$env:DEBUG='express-validator:*'; node 你的服务入口文件.js
    开启后发起触发错误的请求，控制台会明确打印失败的具体规则，例如isInt校验失败：值包含非数字字符、toInt清理器执行失败：值无法转换为整数等细节，不会只返回通用提示。
• 给单条校验规则临时加自定义标记，快速定位失败规则
  如果单个字段绑定了多条校验、清理规则，可以临时给每条规则加独立标记，一次请求就能定位到触发错误的具体规则：

  body('age')
    .isInt({ min: 18 }).withMessage('规则1：年龄必须是不小于18的整数')
    .toInt().withMessage('规则2：年龄值无法转换为数字类型')
    .custom(val => {
      if (val > 120) throw new Error('年龄超出合理范围')
      return true
    }).withMessage('规则3：年龄自定义业务校验失败')
  

• 重点排查清理器（sanitizer）的隐式报错
  大部分无明确诱因的Invalid Value都不是格式校验规则触发的，而是字段上绑定的清理器执行失败：比如给字段加了.toInt()但传入值是"18a"，转换后得到NaN，后续所有校验都会直接抛出通用错误，这类问题在debug日志中会明确标记清理器执行阶段失败。

排查阶段不要使用result.formatWith()对错误做自定义格式化，这类逻辑很容易过滤掉携带根因的原始错误字段，等定位问题后再加格式化逻辑即可。

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