JSON Schema 校验与生成工具
按 JSON Schema 校验数据并定位错误路径,也可从样例 JSON 反推 Schema,或按 Schema 生成示例数据,全部本地完成。
工具介绍
JSON Schema 校验工具用于确认接口返回、配置文件或测试数据是否真正符合契约。错误会按实例路径与关键字列出,缺字段、类型不符都能直接定位到具体位置,不必再对着两份大 JSON 人工比对。
同一页面还提供两个配套能力:样例转 Schema 可以从真实返回体反推 draft-07 结构,是给已有接口补契约最快的方式;Schema 生成数据则按固定种子产出示例对象,方便做可复现的测试数据。
工具特点
错误定位到路径
每条错误给出路径、关键字与原因,可直接贴进问题单。
从样例反推 Schema
把一段真实返回转成包含 properties、required 与数组 items 的契约。
按 Schema 造数
用固定种子生成可复现的示例数据,适合前端 mock 与联调。
本地执行
校验在浏览器内完成,不上传数据,线上报文也可以放心粘贴。
使用场景
契约回归
后端改动上线前,用捕获的响应对照 Schema 跑一遍,提前发现字段缺失。
快速补契约
拿一条真实响应反推出结构,再按需补充约束,省去从零手写。
准备联调数据
按接口 Schema 生成一致的示例数据,供前端 mock 与集成测试使用。
使用步骤
- 1在「校验」页粘贴 JSON 与对应 Schema。
- 2执行校验,失败时查看错误表格定位问题。
- 3切换到「样例转 Schema」,用真实数据反推契约。
- 4需要造数时切到「Schema 生成数据」,设置条数与种子后生成。
常见问题
支持哪个 Schema 版本?
以 draft-07 的常用关键字为主,不包含远程 $ref 解析与 2020-12 的全部关键字。
数据会上传到服务器吗?
不会。校验引擎在页面内加载,所有校验与生成都在浏览器本地完成。
