Joi校验：自定义错误消息中捕获传入值的问题

我懂你现在的纠结：为了避免字段为空时弹出多条重复错误消息，不得不把Joi.string()改成Joi.any()，但切换类型后发现valid('Dummy')这类特定规则的自定义消息没法正常显示，虽说空值的错误已经处理好了。下面给你几个实用的解决思路：

1. 保留string类型，用messages精准控制错误消息 #

其实完全不用切换到any类型也能避免多条错误提示。Joi从v16版本开始推荐用messages替代旧的language配置，它能精准覆盖特定规则的错误，同时屏蔽掉不需要的默认消息。

示例代码：

const bodySchema = Joi.object({
  field1: Joi.string()
    .required()
    .valid('Dummy')
    .messages({
      'string.empty': '字段field1不能为空',
      'any.required': '字段field1为必填项',
      'any.only': '字段field1必须为"Dummy"'
    })
});

这里的关键细节：

• 用messages替代language，语法更直观且兼容新版Joi
• 只声明你需要的错误类型，避免默认的多条冗余消息弹出
• 针对valid规则，对应的错误码是any.only，不管你用string还是any类型都适用

2. 若必须用any类型，正确匹配错误码 #

如果你因为特定业务场景一定要用Joi.any()，那得注意any类型的错误码覆盖逻辑：

const bodySchema = Joi.object({
  field1: Joi.any()
    .required()
    .valid('Dummy')
    .messages({
      'any.required': '字段field1不能为空',
      'any.only': '字段field1必须为指定值"Dummy"'
    })
});

需要注意：

• any类型没有string.empty这类细分错误码，空值场景会直接触发any.required（因为你加了required()规则）
• 确保自定义消息对应的错误码是any.only，这是valid规则对应的通用错误码

3. 进阶技巧：全局配置自定义消息（减少重复代码） #

如果多个校验规则都需要相同的自定义消息，可以全局配置Joi的默认消息，避免每个字段重复写：

Joi.defaults((schema) => schema.messages({
  'any.required': '{{#label}}为必填项',
  'any.only': '{{#label}}必须为指定值: {{#valids}}',
  'string.empty': '{{#label}}不能为空'
}));

这样后续定义的所有schema都会自动应用这些消息，代码更简洁。

最后提个小建议：Joi的language是旧版API，现在官方更推荐用messages，建议升级到最新版Joi并使用新API，兼容性和可读性都会更好。

内容的提问来源于stack exchange，提问作者Saikumar Kunchakuri