JSON Schema中如何跨文件引用属性？现有引用方式校验不生效求助

问题原因 #

校验规则不生效是两个核心问题导致的：

1. JSON Pointer引用路径错误：你当前$ref指向的是def_id/def_title父对象，而不是实际包裹校验规则的子节点，相当于把父对象当成了校验规则，自然不会生效。
2. 部分JSON Schema校验器默认不会自动加载外部引用文件，需要额外配置文件解析逻辑。

修复方案 #

方案1：调整引用路径（最直接）

直接把$ref的指针指向实际的校验规则节点即可，改后主Schema代码如下：

{
    "$schema": "http://json-schema.org/draft-07/schema#",
    "type": "object",
    "properties": {
      "id": { "$ref": "type/common.json#/def_id/id" },
      "title": { "$ref": "type/book.json#/def_title/title" }
    }
}

这里的#/def_id/id是JSON Pointer的标准写法：以/开头逐层匹配嵌套节点，最终定位到你写的id校验规则上。

方案2：调整公共文件结构（更规范）

如果不想每次引用都写多层路径，可以直接把公共定义的校验规则提到def_id、def_title层级，不需要额外套一层key：
修改后的type/common.json：

{
  "def_id": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" 
  }
}

修改后的type/book.json：

{
  "def_title": {
    "anyOf": [
      { "type": "null" },
      { "type": "string" }
    ]
  }
}

调整后你原来的$ref写法就可以正常生效。

额外注意事项 #

修改路径后如果还是不生效，要检查你用的JSON Schema校验器配置：

• 大部分校验器（比如AJV、Python的jsonschema库）默认不会自动读取本地文件系统的外部引用，需要手动调用addSchema方法提前把两个公共Schema加载到校验器实例里，才能正确解析跨文件的$ref。

内容的提问来源于stack exchange，提问作者Samuel Da Costa