如何使用 Joi 实现“两个日期字段至少一个有效”的校验逻辑-js教程-PHP中文网

如何使用 Joi 实现“两个日期字段至少一个有效”的校验逻辑

本文详解如何借助 Joi 的 empty() 与 .or() 组合，精准实现“两个必传字段中至少一个为合法 ISO 日期字符串”的校验需求，避免空字符串被误判为有效日期或导致全空时意外通过。

本文详解如何借助 joi 的 `empty()` 与 `.or()` 组合，精准实现“两个必传字段中至少一个为合法 iso 日期字符串”的校验需求，避免空字符串被误判为有效日期或导致全空时意外通过。

在使用 Joi 进行数据校验时，常见的“二选一”场景（如 date1 或 date2 至少一个有效）看似简单，但若处理不当，极易因空字符串（""）、null 或格式不一致引发校验偏差。核心难点在于：既要允许空值作为占位符，又不能让全空状态通过校验。

Joi 默认将空字符串 "" 视为非法日期，直接调用 .date() 会报错（如 "date2" must be a valid date）；而若用 .allow("")，则空字符串会被接受，导致 { date1: "", date2: "" } 意外通过 —— 这违背了“至少一个有效”的业务约束。

✅ 正确解法是结合 .empty("") 与 .iso()：

const Joi = require('joi');

const schema = Joi.object({
  date1: Joi.date().iso().empty(''),
  date2: Joi.date().iso().empty(''),
}).or('date1', 'date2');

.iso()：强制仅接受 ISO 8601 格式（如 "2023-12-01T20:00:00" 或 "2023-12-01"），避免 Joi.date() 宽松解析数字（如 123 被转为时间戳）带来的安全隐患；
.empty('')：明确声明空字符串 "" 是该字段的“空值”语义，即不参与日期解析，仅作占位符；它不同于 .allow('')（后者会让空字符串通过校验）；
.or('date1', 'date2')：要求二者中至少一个非空且有效（即：非空字符串 + 解析成功）。

✅ 校验效果示例：

// ✅ 通过：date1 有效，date2 为空
schema.validate({ date1: '2023-12-01', date2: '' });

// ✅ 通过：两者均有效
schema.validate({ date1: '2023-12-01', date2: '2023-12-02' });

// ❌ 失败：两者均为空 → 不满足 .or() 条件
schema.validate({ date1: '', date2: '' }); 
// 错误：{ error: '"value" must contain at least one of [date1, date2]' }

// ❌ 失败：date1 格式错误（非 ISO）
schema.validate({ date1: 'invalid-date', date2: '' });
// 错误：{ error: '"date1" must be a valid ISO 8601 date' }

⚠️ 注意事项：

若需支持自定义日期格式（如 "YYYY-MM-DD HH:mm:ss"），请改用 .date().format('YYYY-MM-DD HH:mm:ss').empty('')，并确保安装 joi-date-extensions 插件；
避免混用 .allow('') 和 .empty('') —— 前者放宽校验，后者精准标记空值语义；
.or() 作用于整个 object schema，要求至少一个目标字段存在且满足其自身规则（.empty('') 后的空字符串不视为“满足”，故全空必失败）。