如何使用AJV验证数组中必须包含指定元素？

你的核心需求是确保数组至少包含所有指定的元素，允许存在额外元素，但指定元素一个都不能少。之前的尝试错误在于没有正确使用数组级别的关键字，下面一步步给你解决方案：

为什么之前的方法失败？ #

• 你最初把allOf放在items里：这会要求数组中的每一个元素都匹配所有三个子Schema（同时是Bob、Jim、John），显然不可能实现你的需求。
• 后来尝试的contains用法层级错误：contains是数组级别的关键字，应该直接作用于people数组本身，而不是嵌套在items的规则里。

正确的JSON Schema写法 #

我们需要用allOf包裹多个contains规则，每个contains对应一个必须存在的元素的验证条件。这样数组必须满足所有contains规则，也就是每个指定元素都至少出现一次：

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "required": ["people"],
  "properties": {
    "people": {
      "type": "array",
      // 定义数组元素的基本结构（允许额外元素，只要符合这个基础结构）
      "items": {
        "type": "object",
        "properties": {
          "name": {"type": "string"},
          "age": {"type": "string"}
        },
        "required": ["name", "age"]
      },
      // 要求数组同时包含所有指定元素
      "allOf": [
        {
          "contains": {
            "type": "object",
            "properties": {
              "name": {"const": "Bob"},
              "age": {"const": "26"}
            },
            "required": ["name", "age"]
          }
        },
        {
          "contains": {
            "type": "object",
            "properties": {
              "name": {"const": "Jim"},
              "age": {"const": "35"}
            },
            "required": ["name", "age"]
          }
        },
        {
          "contains": {
            "type": "object",
            "properties": {
              "name": {"const": "John"},
              "age": {"const": "27"}
            },
            "required": ["name", "age"]
          }
        }
      ]
    }
  }
}

验证逻辑说明 #

• items部分：定义了数组中每个元素的基本格式（必须是包含name和age字符串属性的对象），额外元素只要符合这个格式就会被允许。
• allOf + contains：每个contains规则要求数组中至少有一个元素匹配对应的子Schema，allOf则要求所有这些contains规则都被满足——也就是说，数组必须同时包含Bob、Jim、John这三个元素，顺序不影响验证结果。

测试你的示例 #

• 有效数组：[{"name":"Bob","age":"26"},{"name":"Jim","age":"35"},{"name":"John","age":"27"},{"name":"Tim","age":"47"}]
  满足所有contains规则，验证通过。
• 无效数组：[{"name":"Bob","age":"26"},{"name":"Jim","age":"35"},{"name":"Tim","age":"47"}]
  缺少John对应的元素，第三个contains规则不满足，验证失败。

你的AJV代码无需修改 #

你现有的AJV代码可以直接使用这个正确的Schema，运行后就能得到预期的验证结果：

const Ajv = require('ajv');
const jsonInput = require('./people.json');
const schema = require('./peopleSchema.json');
const ajv = new Ajv();
const validate = ajv.compile(schema);
const valid = validate(jsonInput);
console.log(valid);
if (!valid) console.log(validate.errors);

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