如何在JSON Schema中定义符合指定Schema的预设可选对象属性？

云上老周

2026-7-16

解决方案

你可以用allOf关键字把枚举限制和schema验证结合起来，这样既要求值必须是枚举里的预设对象，又强制这些对象符合你定义的fruit schema规范。另外先纠正你现有schema里的一个错误：$defs.fruit中的properties应该是对象类型，不是数组，这是JSON Schema的语法要求。

具体实现步骤：

先修正$defs里的fruit schema，把properties改成对象结构，确保它能正确验证水果对象的格式。
使用allOf数组，同时包含enum（指定允许的预设对象）和$ref（引用fruit schema做格式验证）。这样枚举里的每个对象都会被自动校验是否符合fruit的规范，不符合的话整个schema会报错。

修正后的完整schema示例：

{
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "description": "this is my favorite fruit",
    "allOf": [
        {
            "enum": [
                {
                    "name": "apple",
                    "color": "red"
                },
                {
                    "name": "banana",
                    "color": "yellow"
                },
                {
                    "name": "oops, that's not a fruit",
                    "taste": "fantastic"
                }
            ]
        },
        {
            "$ref": "#/$defs/fruit"
        }
    ],
    "$defs": {
        "fruit": {
            "type": "object",
            "properties": {
                "name": {
                    "type": "string"
                },
                "color": {
                    "type": "string"
                }
            },
            "required": [
                "name",
                "color"
            ],
            "unevaluatedProperties": false
        }
    }
}