Elysia Tools
导航
Validation
验证JSON数据是否符合JSON Schema结构定义
详情
JSON模式校验器是一个强大的工具，用于根据预定义的模式验证JSON数据。它确保您的JSON数据符合预期的结构、数据类型和约束条件。
JSON数据：
{
"name": "张三",
"age": 30,
"email": "[email protected]"
}
JSON Schema：
{
"type": "object",
"properties": {
"name": { "type": "string", "minLength": 1 },
"age": { "type": "integer", "minimum": 0, "maximum": 150 },
"email": { "type": "string", "format": "email" }
},
"required": ["name", "age"]
}
JSON数据：
{
"tags": ["javascript", "typescript", "vue"]
}
JSON Schema：
{
"type": "object",
"properties": {
"tags": {
"type": "array",
"items": { "type": "string" },
"minItems": 1,
"uniqueItems": true
}
}
}
JSON数据：
{
"user": {
"id": 123,
"profile": {
"firstName": "李",
"lastName": "四"
}
}
}
JSON Schema：
{
"type": "object",
"properties": {
"user": {
"type": "object",
"properties": {
"id": { "type": "integer" },
"profile": {
"type": "object",
"properties": {
"firstName": { "type": "string" },
"lastName": { "type": "string" }
},
"required": ["firstName", "lastName"]
}
},
"required": ["id", "profile"]
}
}
}
| 错误 | 原因 | 解决方案 |
|---|---|---|
| 缺少必需字段 | 未找到必需属性 | 添加缺失的属性 |
| 期望类型X，实际为Y | 数据类型不匹配 | 更正数据类型 |
| 不允许有额外属性 | 当设置additionalProperties: false时有额外属性 |
删除额外属性或允许它 |
| 字符串不匹配模式 | 正则表达式模式验证失败 | 更新字符串以匹配模式 |
| 数组必须至少有X项 | 数组太短 | 添加更多项或调整minItems |
| 值必须是以下之一 | enum约束失败 | 使用允许的值之一 |
description和title字段additionalProperties: false - 捕获属性名称中的拼写错误required - 仅强制执行真正必填的字段执行
填写表单、运行工具，并在同一页面查看结果。
案例
相关内容
工具使用指南
JSON模式校验器是一个在线工具，用于根据预定义的 JSON Schema 结构定义快速验证 JSON 数据的正确性。它支持 draft-04 到 2020-12 等多个版本的规范，能够精准检测数据类型、必需字段、数值范围及格式约束，确保您的 JSON 数据符合预期的结构和业务规则。
背景
正在开发用户注册接口，需要确保前端传来的 JSON 数据包含必填的用户名和邮箱，且邮箱格式正确。
问题
手动编写代码校验字段繁琐且易漏，需要使用 JSON Schema 快速验证请求体。
如何使用
在“JSON数据”中输入用户提交的表单数据，在“JSON Schema”中输入定义了 required 字段和 format: "email" 的 Schema，点击验证。
{
"type": "object",
"properties": {
"username": { "type": "string", "minLength": 3 },
"email": { "type": "string", "format": "email" }
},
"required": ["username", "email"]
}结果
校验器准确指出邮箱格式是否正确以及是否缺失必填的 username 字段。
背景
需要验证商品列表 API 返回的 JSON 数组中，商品 ID 是否唯一，且数组长度是否符合预期。
问题
接口返回的商品列表数据量大，难以人工确认是否存在重复的商品 ID 或空列表。
如何使用
将 API 返回的 JSON 数组填入“JSON数据”，在“JSON Schema”中配置 uniqueItems: true 和 minItems: 1 的规则进行校验。
{
"type": "object",
"properties": {
"products": {
"type": "array",
"items": { "type": "integer" },
"minItems": 1,
"uniqueItems": true
}
}
}支持 draft-04、draft-06、draft-07、2019-09 以及 2020-12 版本。
会的第一时间指出哪个属性未通过验证，并说明具体的错误原因，例如类型不匹配或缺少必需字段。
您可以在 JSON Schema 中将 additionalProperties 属性设置为 false。
支持，您可以在 Schema 中使用 format 关键字来验证内置格式，如 email、uri 等。
支持，您可以通过在 Schema 的 properties 中嵌套定义 object 类型来验证任意深度的嵌套结构。
结果
校验器自动检测数组是否为空，并验证数组内的所有商品 ID 是否唯一，输出明确的合规报告。