You need to enable JavaScript to run this app. 如何用JavaScript基于JSON Schema批量校验JSON并修复数组多元素校验失效问题
优惠活动
大模型
产品
解决方案
定价
更多

如何用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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.02 21:15:04