本文介绍在 joi 中高效复用已有对象 schema 字段（如 `a`、`b`）的方法：通过 `schema.keys()` 动态扩展属性，避免误继承 `.xor()`、`.messages()` 等顶层配置，实现清晰、可维护的 schema 分层设计。
在使用 Joi 构建复杂数据校验逻辑时，常需复用基础字段定义（如公共字段 a、b），但又不希望连带继承其组合约束（如 .xor()）或错误消息（.messages()）。直接链式调用 .append() 或 .keys() 在已应用顶层规则的 schema 上会保留原有约束，导致行为不符合预期。
正确做法是：将基础字段定义封装为“纯净”的 Joi.object() 实例（不附加 .xor() 或 .messages()），再通过 .keys() 方法进行扩展。该方法仅合并键值定义，完全忽略原 schema 的校验元信息（如 xor、and、messages、label 等），确保干净复用。
以下是推荐实现：
const Joi = require('@hapi/joi'); // Joi v17+（注意：v17.9.1+ 支持此用法）
// ✅ 纯净基础 Schema：仅定义字段结构，无组合规则与消息
const baseSchema = Joi.object({
a: Joi.string().trim().empty(null, ''),
b: Joi.string().guid().empty(null),
});
// ✅ 复用字段并新增 'c'，生成新 object schema
const extendedSchema = baseSchema.keys({
c: Joi.string().trim(),
});
// ✅ 分别添加各自所需的组合约束与消息
const firstSchema = baseSchema.xor('a', 'b')
.messages({
'object.missing': 'One of "a", "b" is required.',
'object.xor': 'Only one of "a", "b" is allowed.',
});
const secondSchema = extendedSchema.xor('a', 'b', 'c')
.messages({
'object.missing': 'One of "a", "b", "c" is required.',
'object.xor': 'Only one of "a", "b", "c" is allowed.',
});⚠️ 注意事项：❌ 错误方式：baseSchema.append({ c: ... }) 或 baseSchema.keys({...}) 在已调用 .xor() 的 schema 上执行 —— 此时 baseSchema 已携带组合规则，.keys() 仍会保留它，导致 secondSchema 意外继承 xor('a','b')；✅ 正确前提：baseSchema 必须是“未增强”的原始对象 schema（即仅 Joi.object({ ... }) 调用后立即保存，未链式添加 .xor()/.messages()）；? 进阶提示：可将 baseSchema 命名为 baseFields 以语义化其职责，提升代码可读性；? Joi v17+ 中 Joi.object().keys() 是标准且稳定 API；若使用旧版（v16 及以下），需改用 Joi.object().concat(Joi.object({...}))，但语义稍弱且不推荐。
总结：Joi 的 Schema 设计应遵循「结构分离、约束后置」原则——字段定义（structure）与业务规则（validation logic）解耦。借助 .keys() 复用字段，再独立绑定 .xor()、.or()、.messages() 等，既能保障复用性，又能精准控制每层 Schema 的行为边界。
