如何用JSON Schema draft-7根据enabled属性管控其他属性的必填与禁用

你遇到的问题核心是**if条件的写法错误**，导致无论enabled取值如何，then块的约束都被强制执行了。我来帮你修正这个Schema，完美实现你要的需求：当enabled: true时必须提供description和count；当enabled: false时，这两个属性必须禁用（不能出现）。

问题根源分析 #

你原来的if条件写的是：

"if": { "properties": { "enabled": true } }

这里的错误在于，properties里的属性值必须是一个JSON Schema，而true在这里是一个“通配符”Schema（表示任何值都满足）。也就是说，只要enabled属性存在（你的根Schema已经要求它必须存在），不管它的值是true还是false，这个if条件都会判定为“匹配”，所以then块的约束会一直生效，这就是为什么你验证{"enabled": false}时也会报错要求必填description和count。

正确的JSON Schema实现 #

下面是符合Draft-7规范的Schema，完全满足你的需求：

{
  "type": "object",
  "properties": {
    "enabled": { "type": "boolean" }
  },
  "required": ["enabled"],
  "additionalProperties": false,
  "if": {
    "properties": {
      "enabled": { "const": true }
    },
    "required": ["enabled"]
  },
  "then": {
    "properties": {
      "enabled": { "type": "boolean" },
      "description": { "type": "string" },
      "count": { "type": "number" }
    },
    "required": ["enabled", "description", "count"]
  },
  "else": {
    "properties": {
      "enabled": { "type": "boolean" }
    },
    "required": ["enabled"],
    "additionalProperties": false
  }
}

关键细节解释 #

1. 修正if条件：
   用{"const": true}来精准匹配enabled的值为true，这样只有当enabled明确为true时，才会触发then块的约束。加上required: ["enabled"]是为了严谨性（虽然根Schema已经要求，但确保if条件的完整性）。

2. then块约束：
   扩展了属性定义，添加description和count的类型规则，并将它们加入required列表，确保enabled: true时这两个属性必须存在且符合类型要求。

3. else块实现禁用：
   当enabled: false时，else块明确规定只能存在enabled这一个属性，additionalProperties: false会禁止任何额外属性（包括description和count）出现，完美实现“禁用”这些属性的要求。

验证测试示例 #

• ✅ 合法数据：{"enabled": true, "description": "示例描述", "count": 10}（符合then块要求）
• ✅ 合法数据：{"enabled": false}（符合else块要求，无多余属性）
• ❌ 错误数据：{"enabled": true}（缺少description和count，触发required错误）
• ❌ 错误数据：{"enabled": false, "count": 5}（出现了被禁用的count属性，触发additionalProperties错误）

内容的提问来源于stack exchange，提问作者Clay Bridges