JSON Schema 校验

JSON Schema 校验是什么

JSON Schema 校验是把一份 JSON 数据与一份 Schema 规则进行匹配，检查数据的结构和内容是否符合预先定义的要求。例如可以规定某个字段必须存在、字段必须是字符串或数字、数组元素必须符合指定结构，以及数值和字符串需要满足特定范围。

JSON 与 Schema 分别是什么

左侧输入要检查的 JSON 数据，右侧输入 JSON Schema。JSON 是实际数据，Schema 是描述数据结构和约束条件的规则，两者需要分别提供，工具会根据 Schema 对 JSON 进行校验。

常见 Schema 规则

常见规则包括 type 指定数据类型、required 指定必填属性、properties 描述对象字段、items 描述数组元素，以及 enum、const、minimum、maximum、minLength、maxLength 等值约束。具体支持范围以页面的校验器实现为准。

校验结果怎么看

校验成功时表示当前 JSON 数据符合提供的 Schema 规则；校验失败时，结果区域会列出不符合规则的位置和原因，便于定位缺少字段、类型错误或值不符合约束等问题。检查错误时，可以先确认路径，再根据对应的 Schema 规则修改 JSON 数据。

JSON Schema 的 required 怎么用

required 用于指定对象中必须存在的属性。例如 Schema 设置 required: [\"name\"]，表示 JSON 对象必须包含 name 属性。需要注意，required 检查的是属性是否存在，并不单独决定属性值的类型，字段类型仍应通过 properties 中的 type 等规则定义。

properties 与 additionalProperties

properties 用于描述对象中的具体字段，例如为 name 指定字符串类型，为 age 指定数字类型。additionalProperties 可以进一步控制 Schema 没有定义的额外属性是否允许出现。需要禁止未知字段时，可以在对象 Schema 中明确设置相应规则。

怎么校验本地 JSON 文件

切到上传文件页签，可以分别为 JSON 数据和 Schema 选择本地文件。文件会在浏览器中读取并用于校验，适合直接检查本地配置文件、接口数据或其他 JSON 文档。单文件大小限制以页面提示为准。

校验失败怎么排查

如果结果提示 JSON 格式错误，先确认输入内容本身是合法 JSON；如果 JSON 可以解析但 Schema 校验失败，再根据错误路径检查对应字段。常见问题包括 required 缺少必填属性、type 类型不匹配、数组元素结构不符合 items、枚举值不在 enum 列表中，以及数值或字符串超出约束范围。

JSON Schema 校验适合什么场景

JSON Schema 常用于接口数据校验、配置文件检查、前后端数据约束、批量数据处理和开发测试。先定义数据结构，再使用 Schema 对实际 JSON 进行校验，可以在数据进入后续流程前发现结构和字段问题。