本文介绍在 joi 中安全复用基础 schema 属性（如字段定义）的方法，避免意外继承 `.xor()`、`.messages()` 等链式配置，核心是使用 `object.keys()` 方法重置 schema 结构。
在使用 Joi 构建复杂验证逻辑时，常需复用已有字段定义（如 a 和 b 的类型、修饰符等），但又不希望继承其附加的约束（如 .xor()）或错误消息（.messages()）。直接对已链式调用的 schema 调用 .append() 或 .keys() 会保留原有元信息，导致行为不符合预期。
正确做法是：将基础字段定义封装为“纯净”的 Joi.object() 实例（即仅含 keys，无链式修饰），再通过 .keys() 方法扩展新字段。该方法会创建一个全新 schema，仅继承原始对象的键值定义，彻底剥离所有后续链式配置（如 xor、messages、requiredKeys 等）。
以下为推荐实现：
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),
});
// ✅ 使用 .keys() 复用并扩展字段（自动清除原有 xor/messages）
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.keys({...}) 是关键：它返回一个新 schema 实例，仅保留原始 keys 定义，不会携带 xor、messages、label() 等链式状态；
- ❌ 错误示例：baseSchema.append({ c: ... }) 会保留原 xor 和 messages，导致二次应用冲突；
- ❌ 避免在已调用 .xor() 或 .messages() 后再调用 .keys() —— 应始终从“纯净 schema”出发；
- Joi v17+ 中 Joi.object() 默认返回不可变 schema，每次链式调用均生成新实例，因此 baseSchema 必须是未修饰的原始定义。
总结：Joi 的 object.keys() 不仅用于覆盖字段，更是解耦“结构定义”与“业务约束”的核心工具。将字段定义（schema structure）与验证策略（validation rules）分离，可显著提升 schema 的可维护性与复用性。
