如何在JSON Schema数组项中正确引用外部文件并实现校验？

出现_WrappedReferencingError: Unresolvable: ./a.json的核心原因是校验工具无法正确定位或加载被引用的a.json文件，以下是具体解决方案：

1. 给Schema文件添加$id标识符（推荐） #

为每个Schema文件设置唯一的$id，让引用关系基于标识符而非文件路径，提升可移植性。

a.json（Article Schema） #

{
  "$id": "https://your-domain/schemas/article",
  "type": "object",
  "required": ["author", "title"],
  "properties": {
    "author": { "type": "string" },
    "title": { "type": "string" }
  }
}

p.json（Publisher Schema） #

通过$id引用Article Schema：

{
  "$id": "https://your-domain/schemas/publisher",
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "articles": {
      "type": "array",
      "items": { "$ref": "https://your-domain/schemas/article" }
    }
  }
}

2. 基于相对路径引用（需校验工具支持） #

如果坚持用文件路径引用，需确保校验工具能正确加载本地文件。以常用的Ajv库为例，需手动加载被引用的Schema：

代码示例（Node.js环境） #

const Ajv = require('ajv');
const fs = require('fs');
const ajv = new Ajv();

// 先加载Article Schema并注册
const articleSchema = JSON.parse(fs.readFileSync('./a.json', 'utf8'));
ajv.addSchema(articleSchema, 'article');

// 加载并编译Publisher Schema
const publisherSchema = JSON.parse(fs.readFileSync('./p.json', 'utf8'));
const validate = ajv.compile(publisherSchema);

// 测试缺失author的无效数据
const invalidData = {
  name: 'Tech Press',
  articles: [{ title: 'Missing Author' }]
};

console.log(validate(invalidData)); // 返回false
console.log(validate.errors); // 会输出author字段缺失的校验错误

此时p.json的引用可写为：

{
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "articles": {
      "type": "array",
      "items": { "$ref": "./a.json" }
    }
  }
}

常见避坑点 #

• 未设置$id时，部分校验工具无法解析相对路径引用
• 需确保被引用的Schema文件已被加载到校验工具的上下文环境中
• 相对路径写法要准确（比如同目录下的./a.json不能写成a.json或../a.json）

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