Joi校验规则失效求助：基于角色与企业注册状态的条件校验

需求回顾 #

• 当isCompanyRegistration: true且role: VERIFIED_SELLER时，company字段必须存在（必填）
• 当isCompanyRegistration: false且role: SELLER时，personal_document字段必须存在（必填）

常见失效原因 #

很多人尝试条件校验时失效，大多是因为没正确组合多个判断条件，或者忽略了unknown()的使用——如果请求包含未定义的额外字段，会导致条件判断不触发。

正确的Schema实现 #

const Joi = require('joi');

const userSchema = Joi.object({
  isCompanyRegistration: Joi.boolean().required(),
  role: Joi.string().valid('SELLER', 'VERIFIED_SELLER').required(),
  company: Joi.object({
    name: Joi.string().required(),
    taxId: Joi.string().required()
    // 可根据实际需求添加更多company子字段规则
  }),
  personal_document: Joi.string()
})
// 第一个条件分支：企业注册且为认证卖家时必填company
.when(Joi.object({ isCompanyRegistration: true, role: 'VERIFIED_SELLER' }).unknown(), {
  then: Joi.object({ company: Joi.required() })
})
// 第二个条件分支：个人注册且为普通卖家时必填personal_document
.when(Joi.object({ isCompanyRegistration: false, role: 'SELLER' }).unknown(), {
  then: Joi.object({ personal_document: Joi.required() })
});

代码逻辑说明 #

1. 先定义基础字段规则：isCompanyRegistration和role都是必填项，company和personal_document先定义结构但不强制必填。
2. 用两次独立的when分别处理两个条件（分开写比嵌套更清晰），每个when的判断条件是一个Joi.object()组合两个字段的匹配规则，加上unknown()允许请求包含其他未定义字段，避免条件判断被干扰。
3. 当匹配到对应条件时，通过then强制要求对应字段为必填。

测试示例 #

• 符合企业认证卖家要求的有效请求：

const validCorpReq = {
  isCompanyRegistration: true,
  role: 'VERIFIED_SELLER',
  company: { name: 'Acme Inc', taxId: '987654321' },
  email: 'contact@acme.com' // 额外字段不影响校验
};
// 校验通过

• 符合个人卖家要求的有效请求：

const validPersonalReq = {
  isCompanyRegistration: false,
  role: 'SELLER',
  personal_document: 'ID-789456',
  phone: '1234567890' // 额外字段不影响校验
};
// 校验通过

• 不符合条件的错误请求（企业认证卖家缺少company）：

const invalidCorpReq = {
  isCompanyRegistration: true,
  role: 'VERIFIED_SELLER'
};
// 校验失败，返回错误提示："company" is required

内容的提问来源于stack exchange，提问作者Arjun Adhikari