能否纯用JSON Schema验证两类自定义规则？附相关技术疑问

我来逐个拆解你的问题和疑问：

两个特殊校验条件的实现可能性 #

1. 所有object类型节点的properties属性必须全部出现在required列表里 #

遗憾的是，纯JSON Schema无法实现这个规则。

原因在于：JSON Schema的关键字（比如required）依赖静态定义的值，而你需要动态获取当前被校验Schema实例中properties的所有键，并要求这些键全部出现在required数组里。JSON Schema没有内置语法能让你引用当前实例的动态内容（比如properties的键列表）来生成required的枚举值。虽然有递归引用的$ref或$dynamicRef，但它们只能引用Schema文档本身的片段，无法访问被校验的实例数据。所以这个规则必须靠自定义校验器来完成，就像你现在用Python实现的那样。

2. "$schema"必须且仅能出现在Schema根节点 #

这个完全可以用纯JSON Schema实现！

核心思路是：允许根节点拥有$schema字段，但禁止任何子级object节点包含该字段。示例Schema如下：

{
  "type": "object",
  // 根节点允许$schema字段，类型为字符串
  "properties": {
    "$schema": { "type": "string" }
  },
  // 匹配根节点除$schema外的所有属性
  "patternProperties": {
    "^(?!\\$schema$).*$": {
      "anyOf": [
        // 如果属性值是object，禁止它包含$schema字段
        { "type": "object", "not": { "required": ["$schema"] } },
        // 非object类型的属性不受限制
        { "type": ["array", "string", "number", "boolean", "null"] }
      ]
    }
  }
}

你的两个疑问解答 #

1. 是否可引用当前校验实例（类似"$ref":"#"引用当前Schema） #

绝对不行！这里要明确一个关键区别：$ref关键字的作用是引用JSON Schema文档内部或外部的Schema片段，比如"$ref":"#"是引用整个Schema文档本身，而不是引用正在被校验的实例数据。JSON Schema的所有校验逻辑都是基于预定义的Schema规则，没有语法支持直接引用实例的动态内容来构建校验规则。

2. 能否用"dependencies"校验器验证第一个条件 #

答案是不能。

dependencies的设计逻辑是：当实例中存在某个属性时，必须满足对应的依赖条件（比如同时存在另一个属性，或实例符合某个Schema）。但你的第一个条件是针对Schema结构的要求——“如果properties里定义了X，那么required必须包含X”，这完全超出了dependencies的适用场景，它无法关联properties字段的内容和required字段的内容。

总结 #

• "$schema"仅在根节点：可纯用JSON Schema实现；
• 所有properties属性必须在required里：无法纯用JSON Schema实现，必须依赖自定义校验器；
• 无法引用当前校验实例，$ref仅用于Schema片段引用；
• dependencies不适合验证第一个条件。

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