在 JSON Schema 中使用 $ref 和其他属性

Question

例如，在 JSON 架构中，拥有 $ref 和其他属性是有效的。

{
    "$schema": "http://json-schema.org/draft-04/schema#",
    "type": "object",
    "title": "My schema",
    "properties": {
        "scripts": {
            "$ref": "#/definitions/scriptsBase",
            "description": "More docs.",
            "minLength": 10
        }
    },
    "definitions": {
        "scriptsBase": {
            "type": "string",
            "description": "Base Description",
            "minLength": 5
        }
    }
}

如果这是允许的，那么在解析$refed 和$refing 模式中定义的属性时有什么规则（在本例中为minLength 和description。但这可能会变成如果allOf 等都在两者中定义，则要复杂得多。

Answer 1

在json schema property description and "$ref" usage 中找到答案，基本上如果 $ref 存在，所有其他属性都会被忽略。

https://datatracker.ietf.org/doc/html/draft-pbryan-zyp-json-ref-03#section-3

1. 语法

JSON 引用是一个 JSON 对象，其中包含一个名为
的成员 "$ref"，它有一个 JSON 字符串值。示例：

{ "$ref": "http://example.com/example.json#/foo/bar" }

如果一个 JSON 值没有这些特征，那么它应该 不被解释为 JSON 参考。

“$ref”字符串值包含一个 URI [RFC3986]，它标识 被引用的 JSON 值的位置。这是一个错误
如果字符串值不符合 URI 语法规则，则为条件。
JSON 引用对象中除“$ref”之外的任何成员都应为
忽略。