如何在JSON Schema中实现带共享属性的对象继承并禁用额外属性

完全可行，用JSON Schema的allOf关键字就能实现你的需求——既不用重复定义共享属性，又能严格禁止额外属性。

核心思路 #

• 把共享属性（比如color）和类型标识kind统一放在基础Schema里
• 每个子类型用allOf组合基础Schema和自身的专属属性规则
• 在子类型的最外层设置"additionalProperties": false，这样就能仅允许「基础属性+子类型专属属性」，禁止任何额外字段

具体示例代码 #

1. 定义基础Shape Schema（共享属性） #

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "definitions": {
    "baseShape": {
      "type": "object",
      "required": ["kind", "color"],
      "properties": {
        "kind": {
          "enum": ["sphere", "cube"]
        },
        "color": {
          "type": "string"
        }
      }
    }
  }
}

2. 定义Sphere子类型Schema #

{
  "allOf": [
    {"$ref": "#/definitions/baseShape"},
    {
      "type": "object",
      "required": ["radius"],
      "properties": {
        "radius": {
          "type": "number",
          "minimum": 0
        }
      }
    }
  ],
  "additionalProperties": false
}

3. 定义Cube子类型Schema #

{
  "allOf": [
    {"$ref": "#/definitions/baseShape"},
    {
      "type": "object",
      "required": ["edge"],
      "properties": {
        "edge": {
          "type": "number",
          "minimum": 0
        }
      }
    }
  ],
  "additionalProperties": false
}

验证效果 #

• 合法实例：
  • {"kind":"sphere", "radius":5, "color":"red"} → 验证通过
  • {"kind":"cube", "edge":3, "color":"green"} → 验证通过
• 非法实例（禁止额外属性）：
  • {"kind":"sphere", "radius":5, "color":"red", "volume":100} → 验证失败（volume属于额外字段）
  • {"kind":"cube", "edge":3, "weight":20} → 验证失败（缺少必填的color，且weight是额外字段）

为什么之前的写法失效？ #

你之前的问题出在additionalProperties的作用范围：

• 如果在基础Schema里加"additionalProperties": false，子类型的专属属性（radius/edge）会被判定为「额外属性」直接禁止
• 如果只在子类型里加"additionalProperties": false，又没把基础的color纳入允许范围，导致color被判定为额外属性

而用allOf组合后，基础属性和子类型属性会被合并成完整的允许字段列表，再配合外层的additionalProperties: false，就能精准控制允许的字段，同时彻底避免重复定义共享属性。

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