本文介绍如何使用 joi 的 `keys()` 方法安全复用基础对象 schema 的字段定义，避免意外继承 `.xor()`、`.messages()` 等链式配置，实现灵活、可组合的 schema 扩展。
在 Joi 中，Schema 实例是不可变（immutable）的，每次调用 .xor()、.messages()、.requiredKeys() 等方法都会返回一个全新 Schema 实例，而非修改原实例。因此，直接对已配置 .xor() 和 .messages() 的 baseSchema 调用 .keys() 或 .append() 时，新 Schema 仍会携带原始链式配置——这正是用户遇到“xor 和 messages 被重复应用”的根本原因。
✅ 正确做法是：先定义纯净的字段结构（即仅含 Joi.object({ ... })），再分别添加验证逻辑（如 .xor()、.messages()）。
以下是推荐的结构化写法：
// ✅ Step 1: 定义纯字段 Schema（无验证逻辑）
const baseFields = Joi.object({
a: Joi.string().trim().empty(null, ''),
b: Joi.string().guid().empty(null),
});
// ✅ Step 2: 复用字段并扩展新属性（.keys() 仅覆盖/合并 keys，不继承链式规则）
const extendedFields = baseFields.keys({
c: Joi.string().trim(),
});
// ✅ Step 3: 分别添加业务级约束（解耦字段定义与验证逻辑）
const firstSchema = baseFields.xor('a', 'b').messages({
'object.missing': 'One of "a", "b" is required.',
'object.xor': 'Only one of "a", "b" is allowed.',
});
const secondSchema = extendedFields.xor('a', 'b', 'c').messages({
'object.missing': 'One of "a", "b", "c" is required.',
'object.xor': 'Only one of "a", "b", "c" is allowed.',
});⚠️ 注意事项：
- ❌ 避免 const baseSchema = Joi.object({...}).xor(...).messages(...); 后再调用 .keys() —— 此时 baseSchema 已携带链式状态，.keys() 返回的新 Schema 仍会继承 .xor() 和 .messages()。
- ✅ Joi.object().keys({...}) 是“纯净起点”，它仅设置字段结构，不引入任何验证约束，是复用的最佳基底。
- ? 若需多次复用（如 baseFields → adminSchema / publicSchema），可统一从 baseFields 派生，确保字段一致性与可维护性。
这种模式不仅解决了当前的复用问题，更符合 Joi 的设计哲学：将 Schema 结构（shape）与验证行为（behavior）分离，提升代码可读性、可测试性与协作效率。
