如何使用express-validator实现基于路由type参数的条件校验

当前问题背景 #

• 基于express-validator搭建的同一路由，通过路径参数:type实现三类业务逻辑的复用，未为每个场景拆分独立接口
• 现有校验逻辑存在全局固定触发的缺陷：无论type取值为哪个业务场景，都会强制触发email2字段的格式校验，完全不符合「仅当type取值为'twoemails'时，才需要校验第二个邮箱字段」的规则
• 此前尝试通过oneOf、anyOf规则做条件配置，始终无法达到预期效果

原有配置失效的核心原因 #

1. 现有email2的校验逻辑未做上下文判断，属于全局生效的固定规则
2. 对校验规则的适用场景存在认知偏差：oneOf、anyOf的设计用途是校验请求体内部的字段组合关系（例如「手机号与邮箱至少填写一项」），无法直接读取路径参数这类请求上下文的取值做条件判断，本身的适用范围就不匹配当前需求，这是配置不生效的根本原因。

修正后的实现方案 #

调整email2的校验规则，使用express-validator内置的when()方法，将校验触发逻辑和路径参数的取值做绑定，完整可运行的代码如下：

myRoute.post('/myendpoint/:type',
  // 修正原代码中twoemails值携带**标记的笔误
  param('type', 'Invalid type').isIn(['oneemail', 'twoemails']),
  // 全场景通用的email1校验规则保持不变
  body('email1', 'first email invalid').isEmail(),
  // 为email2增加条件触发判断：仅当路径参数type为twoemails时，才执行后续的邮箱格式校验
  body('email2', 'second email invalid')
    .when((req) => req.params.type === 'twoemails')
    .isEmail(),
  async (req, res) => {
    const errors = validationResult(req);
    if (!errors.isEmpty()) {
      return res.status(400).json({
        errors: errors.array(),
      });
    }
    // 原有业务逻辑无调整
  }
)

实际运行效果 #

• 当路径参数type为oneemail时，无论email2字段是否传值、传值格式是否合法，都不会触发对应校验错误
• 当路径参数type为twoemails时，会强制校验email2的邮箱格式，格式不合法时返回对应的400错误
• 后续如果需要适配新的业务场景规则，仅需调整when()回调内的判断逻辑即可，不需要拆分独立路由接口

内容的提问来源于stack exchange，提问作者Bilal El Mahdaoui