基于JSON Schema实现继承结构的三类技术疑问咨询

问题回顾 #

你需要用JSON Schema建模继承结构：虚拟基类包含Name（string类型，用于标识派生类）和Price（number类型）两个属性，派生类ClassA新增Color属性，ClassB新增Size属性。原方案因additionalProperties: false禁止了基类的Price属性，导致无法正常工作，以下是针对你三个疑问的解答：

1. 大量派生类场景下，这种建模方法是否可行？ #

可行，但需要优化结构避免冗余。核心思路是用oneOf区分不同派生类，同时通过$ref引用基类Schema实现复用，避免重复编写公共属性。这种方式在派生类数量较多时，能保证Schema的可维护性，每个派生类只需要定义自身特有的属性和Name的枚举约束即可。

2. 是否需要将基类属性Schema复制到每个派生类中，再仅使用oneOf？ #

不需要。可以通过allOf关键字将基类Schema与派生类特有Schema组合，实现属性继承。这样既保留了基类的公共属性约束，又能让派生类专注于自身的特有属性定义，完全避免代码复制。

3. 能否让additionalProperties仅校验派生类中的属性？ #

可以。正确的做法是在派生类的Schema中，通过allOf合并基类Schema和派生类特有Schema，然后在派生类的特有约束部分设置additionalProperties: false。此时additionalProperties的校验范围是基类属性+派生类特有属性的集合，只会禁止这些属性之外的额外字段，不会误判基类的Price等属性为非法字段。

修正后的Schema示例 #

{
  "type": "object",
  "oneOf": [
    {"$ref": "#/$defs/ClassA"},
    {"$ref": "#/$defs/ClassB"}
  ],
  "$defs": {
    "BaseClass": {
      "type": "object",
      "properties": {
        "Name": {"type": "string"},
        "Price": {"type": "number"}
      },
      "required": ["Name", "Price"]
    },
    "ClassA": {
      "allOf": [
        {"$ref": "#/$defs/BaseClass"},
        {
          "properties": {
            "Name": {"enum": ["ClassA"]},
            "Color": {"type": "string"}
          },
          "required": ["Color"],
          "additionalProperties": false
        }
      ]
    },
    "ClassB": {
      "allOf": [
        {"$ref": "#/$defs/BaseClass"},
        {
          "properties": {
            "Name": {"enum": ["ClassB"]},
            "Size": {"type": "number"}
          },
          "required": ["Size"],
          "additionalProperties": false
        }
      ]
    }
  }
}

这个Schema的工作逻辑：

• 基类BaseClass定义公共属性和必填约束；
• 每个派生类通过allOf继承基类，同时覆盖Name的枚举值，定义自身特有属性及必填约束；
• additionalProperties: false仅禁止基类+派生类属性之外的额外字段，既保证了结构严谨性，又不会误判合法的基类属性。

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