JSON Schema中contains与items关键字验证错误信息差异原因咨询

json_path list: [0]
error_message: '' is not of type 'number' #

json_path list: [1]
error_message: '1234' is not of type 'number'

- 使用版本一Schema的输出：

json_path list: []
error_message: ['', '1234'] does not contain items matching the given schema

---

## 原因解释
这是`contains`关键字本身的设计特性，和你的代码无关，核心差异在于两个关键字的验证逻辑和错误报告机制：

1. **`items`的验证逻辑**：
`items`要求数组中**每一个元素**都必须符合指定的Schema规则。验证器会遍历数组的每一个元素，逐个检查是否匹配，所以只要有元素不符合，就会针对该元素生成具体的错误信息，包括元素的路径和错误原因。

2. **`contains`的验证逻辑**：
`contains`的作用是要求数组中**至少存在一个**符合指定Schema的元素，搭配`minContains`/`maxContains`则是要求符合条件的元素数量在指定范围内。验证器的核心目标是确认数组是否满足“包含足够多匹配元素”的整体条件，当所有元素都不符合时，它只会返回数组层面的笼统错误——因为它不需要逐个检查元素的合法性，只需要判断是否存在足够的匹配项。

3. **错误报告的差异**：
`jsonschema`库的错误报告是和验证逻辑绑定的：
- 对于`items`，因为是逐个元素验证，自然能生成每个元素的具体错误；
- 对于`contains`，验证器的关注点在数组整体是否达标，不会深入到元素级去报告每个元素的问题，所以只会返回数组层面的错误。

---

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