如何复用 Joi Schema 的属性定义而不继承验证规则_网络技术

如何复用 Joi Schema 的属性定义而不继承验证规则

发布时间 - 2026-01-05 00:00:00 点击率：次

本文介绍在 joi 中如何安全复用基础 schema 的字段定义，避免意外继承 `.xor()`、`.messages()` 等链式配置，通过 `object.keys()` 方法实现纯净的属性扩展。

Joi 的 Schema 实例是不可变（immutable）的，每次调用 .xor()、.messages()、.requiredKeys() 等方法都会返回一个全新 Schema 实例，而非修改原对象。这意味着：直接对已配置 .xor() 和 .messages() 的 Schema 调用 .keys() 或 .append()，不会污染原始定义，但若你从一个“已增强”的 Schema 出发（如 baseSchema.xor(...).messages(...)），再调用 .keys()，新 Schema 仍会携带之前所有规则 —— 这正是问题根源。

✅ 正确做法是：仅对“纯净”的基础 Schema（即仅含 .object({ ... }) 定义、未附加任何校验逻辑或消息）调用 .keys()。

以下为推荐实践：

const Joi = require('@hapi/joi'); // 或 @joi/browser（v17+）

// ✅ 第一步：定义纯净的基础字段结构（无 xor / messages）
const baseFields = Joi.object({
  a: Joi.string().trim().empty(null, ''),
  b: Joi.string().guid().empty(null),
});

// ✅ 第二步：基于 baseFields 构建不同用途的完整 Schema
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 extendedSchema = baseFields.keys({
  c: Joi.string().trim(),
});

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.',
  });

⚠️ 注意事项：

❌ 避免 const baseSchema = Joi.object({...}).xor(...).messages(...); const reused = baseSchema.keys({...}); —— 此时 reused 仍含 xor 和 messages；
✅ baseFields 必须是 纯 Joi.object() 实例，不带任何链式修饰；
.keys() 是浅合并：若传入同名键（如 a），会完全覆盖原定义；如需条件性扩展，可先用 .describe() 提取结构，或借助 Joi.compile() 动态构建；
Joi v17+ 中 .keys() 已取代旧版 .add()，语义更清晰，推荐统一使用。

总结：Joi 的复用核心在于分层设计——将字段声明（schema structure）与业务规则（validation logic + messages）解耦。baseFields 扮演「类型契约」角色，而各 .xor() + .messages() 组合则作为面向具体场景的「验证策略」。这种模式不仅提升可维护性，也天然支持单元测试中对字段定义的独立断言。

# app # red # Object # const # 继承 # append # 对象 # 链式 # 复用 # 而非 # 如需 # 中对 # 先用 # 第二步 # 旧版 # 仍会 # 若你

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：谷歌浏览器官网下载地址_谷歌Chrome浏览器官方官网下载入

下一篇：lovemo官方入口网页版 lovemo官网直接登录

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：谷歌浏览器官网下载地址_谷歌Chrome浏览器官方官网下载入

下一篇：lovemo官方入口网页版 lovemo官网直接登录