JSON Schema draft2020-12中if语句嵌套$refs失效问题求助

核心问题1：$ref与其他关键字共存的优先级冲突 #

JSON Schema draft 2020-12中，$ref关键字具有最高优先级——当一个对象中同时存在$ref和其他关键字时，其他关键字会被完全忽略。你原代码中的if子模式就犯了这个错误：

{
  "if": {
    "$ref": "#/$defs/ValueItem/properties/dt",
    "const": "type1"
  }
}

这里的const: "type1"会被$ref覆盖，导致条件判断永远不成立，then分支从未触发。因此当dt为type1时，string属性未被定义在AValue的properties中，再结合相关schema的additionalProperties: false限制，就会触发“属性未定义且不允许额外属性”的错误。

核心问题2：Schema层级与数据结构不匹配 #

从你的ValueItem定义来看，它的结构是：

{
  "value": {/* AValue实例 */},
  "dt": {/* DT枚举值 */}
}

如果你的需求是当ValueItem的dt为type1时，要求value（即AValue）必须包含string属性，那么你的if-else逻辑放错了层级——应该写在ValueItem的Schema中，而不是AValue里。因为AValue的实例本身不包含dt属性，你在AValue的Schema里判断dt值，条件永远为假。

修正后的Schema示例 #

场景1：dt是ValueItem的属性，string是AValue的属性 #

调整ValueItem的Schema，在其中添加if-else逻辑：

{
  "$defs": {
    "DT": {
      "type": "string",
      "enum": ["type1", "type2", "type3", "type4"]
    },
    "AValue": {
      "properties": {
        // 基础属性定义
      },
      // 不要设置additionalProperties: false，否则then里的string会被拒绝
      "additionalProperties": true
    },
    "ValueItem": {
      "properties": {
        "value": {"$ref": "#/$defs/AValue"},
        "dt": {"$ref": "#/$defs/DT"}
      },
      "required": ["dt", "value"],
      "additionalProperties": false,
      "allOf": [
        {
          "if": {
            "properties": {
              "dt": {"const": "type1"}
            },
            "required": ["dt"] // 确保dt存在才判断
          },
          "then": {
            "properties": {
              "value": {
                "properties": {"string": {"type": "string"}},
                "required": ["string"]
              }
            }
          }
        }
      ]
    }
  }
}

场景2：dt和string在同一个对象中（即可能误定义了ValueItem） #

如果你的目标数据结构是{dt: "type1", string: "xxx"}，直接简化AValue的Schema即可：

{
  "$defs": {
    "DT": {
      "type": "string",
      "enum": ["type1", "type2", "type3", "type4"]
    },
    "AValue": {
      "properties": {
        "dt": {"$ref": "#/$defs/DT"}
      },
      "required": ["dt"],
      "additionalProperties": false,
      "allOf": [
        {
          "if": {
            "properties": {
              "dt": {"const": "type1"}
            }
          },
          "then": {
            "properties": {
              "string": {"type": "string"}
            },
            "required": ["string"]
          }
        }
      ]
    }
  }
}

关于if语句处理嵌套$ref的问题 #

JSON Schema的if语句完全支持嵌套$ref，只要你正确使用：

• 不要在同一个对象中让$ref与其他关键字共存（可以用allOf包裹，比如allOf: [{"$ref": "..."}, {"const": "..."}]）
• 确保$ref指向的Schema层级与当前校验的对象匹配

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