这个错误出现的原因很直接：jsonschema库要求$ref的值必须是符合URI规范的路径，而你直接写的components/page_layout.json是一个相对文件路径，没有协议标识（比如file://），库不知道该如何解析这个路径类型，所以抛出了"unknown url type"的错误。

下面是两种可行的解决方案，推荐第二种，因为它更灵活且不依赖硬编码的绝对路径：

方案1：将$ref修改为完整的file URI（不推荐） #

你可以把$ref的值替换成目标schema文件的绝对路径并加上file://协议，比如：

"$ref": "file:///Users/yourname/project/schemas/components/page_layout.json"

但这种方法的问题很明显——硬编码的绝对路径在不同环境（比如同事的电脑、服务器）上会失效，维护起来很麻烦，所以不推荐使用。

方案2：使用RefResolver指定基础URI（推荐） #

jsonschema提供了RefResolver类，它可以帮你处理相对路径的引用，只需要指定主schema文件的基础URI，解析器就能自动找到相对路径对应的文件。

具体代码示例 #

假设你的项目目录结构是：

project/
└── schemas/
    ├── components/
    │   └── page_layout.json
    └── page.json

你可以这样编写验证代码：

import json
import os
from urllib.parse import urlparse
from jsonschema import validate, RefResolver

# 1. 获取主schema文件的绝对路径，并转换为标准的file URI
schema_file_path = os.path.abspath("schemas/page.json")
base_uri = urlparse(schema_file_path).geturl()  # 自动处理跨平台路径格式

# 2. 加载主schema
with open(schema_file_path, "r") as f:
    page_schema = json.load(f)

# 3. 创建RefResolver，指定基础URI和主schema
resolver = RefResolver(base_uri=base_uri, referrer=page_schema)

# 4. 加载待验证的JSON数据
with open("your_test_data.json", "r") as f:
    test_data = json.load(f)

# 5. 执行验证
try:
    validate(instance=test_data, schema=page_schema, resolver=resolver)
    print("✅ 数据验证通过！")
except Exception as validation_error:
    print(f"❌ 验证失败：{validation_error}")

关键说明 #

• base_uri是主schema文件的完整file URI，jsonschema会以此为基准，解析所有相对路径的$ref引用。比如你的page.json里写的"$ref": "components/page_layout.json"，解析器会自动定位到schemas/components/page_layout.json。
• 使用urlparse处理路径是为了兼容Windows和Linux/macOS的路径格式，避免出现路径分隔符的问题。
• 如果你的组件schema里还引用了其他子组件，只要相对路径是正确的，RefResolver会自动递归加载这些文件，不需要额外处理。

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