如何用JavaScript基于JSON Schema批量校验JSON并修复数组多元素校验失效问题
核心问题定位
- 原Schema中所有数组字段(
contents、嵌套的files)的items都误用了元组校验模式:当items取值为数组[子Schema]时,仅会按位置校验数组的第0个元素,超出位置的其他元素完全不做校验,这就是多元素校验失效的根本原因。 - 示例JSON中存在拼写错误的多余字段
versionn,不符合Schema要求的必填version字段规则。
修正后的标准Schema配置
const schema = { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "data": { "type": "object", "properties": { "contents": { "type": "array", // 改为对象格式的通用元素校验,移除原有外层数组[] "items": { "type": "object", "properties": { "version": { "type": "string" }, "sequence": { "type": "integer" }, "files": { "type": "array", // 同样移除外层数组[],校验files内所有元素 "items": { "type": "object", "properties": { "fileName": { "type": "string" }, "name": { "type": "string" }, "fileSize": { "type": "string" }, "fileType": { "type": "string" }, "lastUpdatedDate": { "type": "integer" }, "fileLength": { "type": "integer" }, "version": { "type": "integer" } }, "required": ["fileName", "name", "fileSize", "fileType", "lastUpdatedDate", "fileLength", "version"] } } }, "required": ["version", "sequence", "files"] } } }, "required": ["contents"] } }, "required": ["data"] }
批量校验适配说明
- 无需修改原有校验逻辑,只需复用同一个
Validator实例遍历100个待校验JSON即可,不用重复初始化校验器,大幅降低批量校验的性能损耗。 - 若需要严格禁止未定义的额外字段(比如直接识别示例中拼写错误的
versionn),可以在每个对象层级的Schema中添加additionalProperties: false,示例如下:
// 示例:给contents层级的对象添加严格校验 { "type": "object", "properties": { /* 原有字段定义保持不变 */ }, "required": ["version", "sequence", "files"], "additionalProperties": false // 新增规则:不允许出现Schema未定义的字段 }
修正后校验生效规则
- 所有数组字段(无论
contents还是嵌套的files)的任意数量元素都会被完整校验,不会再出现多元素跳过校验的问题。 - 字段类型、必填项规则会对所有嵌套层级生效,包括
files内的每一个文件对象。 - 示例中的拼写错误会被正常识别:「缺少必填的
version字段」,若开启additionalProperties: false还会同时报「存在未定义的versionn字段」。
内容的提问来源于stack exchange,提问作者Suraj Prasad
相关产品推荐
相关产品推荐

