Express-Validator：如何在完成必填参数校验后终止后续校验？

要实现「必填参数校验不通过时直接终止后续格式校验，仅返回缺失参数错误」的需求，核心思路是把必填参数校验和格式校验拆分为独立的校验链，通过中间件控制校验流程——先执行必填校验，只有校验通过后才触发后续的格式校验。

具体实现步骤 #

1. 拆分校验规则

将必填参数校验和格式校验分别定义为独立的规则数组，便于后续分阶段执行：

const { query, oneOf, validationResult } = require('express-validator');

// 第一组：必填参数校验规则
const requiredValidations = [
  // 二选一规则：要么传symbol，要么同时传price和rate
  oneOf([
    query('symbol').exists().withMessage('symbol 参数为必填项'),
    [
      query('price').exists().withMessage('price 参数为必填项'),
      query('rate').exists().withMessage('rate 参数为必填项')
    ]
  ]),
  query('targetRate').exists().withMessage('targetRate 参数为必填项'),
  query('years').exists().withMessage('years 参数为必填项')
];

// 第二组：参数格式校验规则
const formatValidations = [
  query('market').isAlpha('en-US').withMessage('market 必须为英文字符'),
  query('numOfShares').isDecimal().withMessage('numOfShares 必须为小数格式')
];

2. 自定义校验中间件

创建一个中间件，分阶段执行校验：先跑必填校验，有错误直接返回；无错误再执行格式校验：

const validateParams = async (req, res, next) => {
  // 执行必填参数校验
  await Promise.all(requiredValidations.map(validation => validation.run(req)));
  const requiredErrors = validationResult(req);

  // 必填校验不通过，直接返回错误，终止后续流程
  if (!requiredErrors.isEmpty()) {
    return res.status(400).json({ errors: requiredErrors.array() });
  }

  // 必填校验通过，执行格式校验
  await Promise.all(formatValidations.map(validation => validation.run(req)));
  const formatErrors = validationResult(req);

  if (!formatErrors.isEmpty()) {
    return res.status(400).json({ errors: formatErrors.array() });
  }

  // 所有校验通过，进入业务逻辑
  next();
};

3. 路由中使用中间件

将自定义的校验中间件挂载到目标路由上：

app.get('/', validateParams, (req, res) => {
  // 这里处理校验通过后的业务逻辑
  res.send('所有参数校验通过');
});

补充说明 #

如果不想拆分校验链，也可以给每个格式校验规则添加条件判断（仅当参数存在时才执行格式校验），但这种方式在复杂的必填规则（比如二选一）下会更繁琐：

// 示例：仅当market参数存在时，才校验其格式
query('market')
  .if(query('market').exists())
  .isAlpha('en-US')
  .withMessage('market 必须为英文字符')

对比下来，拆分校验链+中间件控制的方式更清晰、易维护，能精准满足「必填校验失败即终止后续所有校验」的需求。

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