如何在AJV中仅当两个字段之一非空时验证目标字段？

API 探路者

2026-5-25

解决AJV中“field2/field3任一非空时field1不能为空”的验证逻辑

我明白你要实现的规则：只要field2或field3有一个不为空，field1就必须有值；如果两个都为空，field1可以为空。你之前卡在了如何表达OR条件上，AJV里可以用anyOf来实现这个逻辑，下面是完整的可行Schema：

{
  "type": "object",
  "properties": {
    "field1": { "type": "string" },
    "field2": { "type": "string" },
    "field3": { "type": "string" }
  },
  "if": {
    "anyOf": [
      { "properties": { "field2": { "minLength": 1 } }, "required": ["field2"] },
      { "properties": { "field3": { "minLength": 1 } }, "required": ["field3"] }
    ]
  },
  "then": {
    "properties": { "field1": { "minLength": 1 } },
    "required": ["field1"]
  },
  "additionalProperties": false // 可选，若需限制仅存在这三个字段可开启
}

关键部分解释：

if块里的anyOf就是用来实现OR逻辑的：只要数组里的任意一个条件满足，就会触发then的规则
每个anyOf子项里的required是为了确保字段存在（如果你的场景允许字段未定义，也可以去掉，但通常建议保留，避免字段未定义时的误判）
then块明确要求field1必须有非空值（minLength:1）且必须存在

对应你的测试用例验证结果：

{ field1: '', field2: '2', field3: '' }：field2非空，触发then，但field1为空 → 无效（符合预期）
{ field1: '', field2: '', field3: '3' }：field3非空，触发then，field1为空 → 无效（符合预期）
{ field1: '1', field2: '2', field3: '3' }：field2/3都非空，field1有值 → 有效（符合预期）
{ field1: '', field2: '', field3: '' }：field2/3都为空，if条件不触发，field1可以为空 → 有效（符合预期）