Elysia Tools

在一个清晰的工作台里浏览工具、案例、可视化和主题指南。

热门分类

专题

语言
ZHDERUPTENFRES

Elysia Tools

导航

Validation

JSON模式校验器

· 最后更新:2025-12-27

验证JSON数据是否符合JSON Schema结构定义

详情

这个工具可以帮你完成什么

JSON模式校验器

概述

JSON模式校验器是一个强大的工具,用于根据预定义的模式验证JSON数据。它确保您的JSON数据符合预期的结构、数据类型和约束条件。

功能

支持的JSON Schema关键字

  • type: 验证数据类型(string、number、integer、boolean、array、object、null)
  • properties: 定义对象属性的模式
  • required: 指定必需的对象属性
  • additionalProperties: 控制是否允许额外的属性
  • items: 定义数组项的模式(单个模式或元组验证)
  • minItems / maxItems: 设置数组长度约束
  • uniqueItems: 要求所有数组项唯一
  • enum: 将值限制为特定集合
  • const: 要求精确的常量值
  • minimum / maximum: 设置数值范围约束
  • exclusiveMinimum / exclusiveMaximum: 排他性数值边界
  • multipleOf: 要求值是某个数字的倍数
  • minLength / maxLength: 设置字符串长度约束
  • pattern: 根据正则表达式验证字符串
  • format: 验证内置格式(email、uri等)
  • allOf: 数据必须匹配所有子模式
  • anyOf: 数据必须匹配至少一个子模式
  • oneOf: 数据必须恰好匹配一个子模式
  • $ref: 引用另一个模式(基本支持)

使用示例

基本对象验证

JSON数据:

{
  "name": "张三",
  "age": 30,
  "email": "zhangsan@example.com"
}

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约束失败 使用允许的值之一

支持的JSON Schema版本

  • draft-04
  • draft-06
  • draft-07
  • 2019-09
  • 2020-12

编写有效模式的技巧

  1. 使用描述性的属性名称 - 使验证错误更清晰
  2. 设置适当的约束 - 在灵活性和严格性之间取得平衡
  3. 记录您的模式 - 使用description和title字段
  4. 测试边界情况 - 使用边界值进行验证
  5. 使用additionalProperties: false - 捕获属性名称中的拼写错误
  6. 谨慎使用required - 仅强制执行真正必填的字段

执行

运行这个工具

填写表单、运行工具,并在同一页面查看结果。

案例

与这个工具匹配的案例

相关内容

继续查看相关工具与专题

由 Elysia Tools 团队编写
JSON107
Schema20
JSON Schema5

工具使用指南

详细了解工具的适用范围、支持能力及用户案例。

关键事实

分类
Validation
输入类型
textarea
输出类型
text
案例覆盖
4
API 可用
是

概览

JSON模式校验器是一个在线工具,用于根据预定义的 JSON Schema 结构定义快速验证 JSON 数据的正确性。它支持 draft-04 到 2020-12 等多个版本的规范,能够精准检测数据类型、必需字段、数值范围及格式约束,确保您的 JSON 数据符合预期的结构和业务规则。

适用场景

  • 在开发 API 接口时,需要验证客户端发送的 JSON 请求体是否符合接口定义的结构规范。
  • 在配置系统或编写配置文件后,需要确保 JSON 配置文件没有遗漏必需字段或填入错误的数据类型。
  • 在调试前端与后端交互数据时,快速定位 JSON 数据中不符合 Schema 约束的具体错误位置。

使用方式

  1. 1在“JSON数据”输入框中粘贴或输入您需要验证的 JSON 数据。
  2. 2在“JSON Schema”输入框中输入对应的 JSON Schema 结构定义。
  3. 3校验器会自动解析并对比两者,实时输出验证结果,若有不符合规则的字段将直接指出错误原因与位置。

常见用途

  • API 请求体结构校验:在后端接收到客户端提交的 JSON 数据前,使用 Schema 校验器确保数据完整性。
  • 配置文件合规性检查:对复杂的 JSON 配置文件进行校验,防止因拼写错误或格式不符导致系统崩溃。
  • 测试数据生成与验证:在编写单元测试时,验证模拟的 JSON 响应数据是否完全符合接口契约。

同类对比

  • 从示例 JSON 自动推断 JSON Schema,支持手动调整并验证数据

  • 格式化和验证JSON数据

  • 对 Model Context Protocol 服务器做端到端契约验证:JSON-RPC 2.0 握手与版本协商、capabilities 交换、tools/list 输入 schema 的 object 根类型与 2020-12 草案编译校验、resources 读写、prompts 获取、ping、未知方法…

适合谁

适合

  • 在浏览器中校验JSON 文本。
  • 需要设置模式草案的工作流,例如Draft 4或Draft 6。
  • 每次用相同设置重复处理JSON 文本的任务。

不适合

  • 完全自动化的批量任务——本页面面向交互使用,脚本请调用 API 端点。
  • 其他格式的内容——本工具只接受JSON 文本。

常见失败与 edge cases

  • 尾随逗号或单引号

    严格的 JSON 解析器会拒绝它们——校验或格式化前请去掉尾随逗号并改用双引号。

  • 超大文件

    大文件处理更慢,还可能触及浏览器内存上限——请先用小样本测试。

  • 不检查输出结果

    正式使用前,请先把输出的前几行或前几页与输入对照检查。

API 与自动化

  • 批量任务

    用 POST https://api.elysiatools.com/zh/api/tools/json-schema-validator 直接传输入调用,免开页面出同样结果;文档页上有现成的 curl、fetch 和 Python 示例。

  • AI 助手调用

    把机器可读的工具说明 /ai/zh/tools/json-schema-validator.md 交给 AI 助手,或用文档页上的 MCP 配置接进来,它就能替你调用这个工具。

  • 流水线与定时任务

    用文档页上的 fetch 或 Python 示例直接从脚本传输入,定时跑同一个任务。

· 通用 API 文档 · AI 可读说明(.md)

示例

1. 用户注册信息表单验证

后端开发工程师

背景

正在开发用户注册接口,需要确保前端传来的 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 字段。

2. 商品列表数组约束校验

测试工程师

背景

需要验证商品列表 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
    }
  }
}

常见问题

这个校验器支持哪些 JSON Schema 版本?

支持 draft-04、draft-06、draft-07、2019-09 以及 2020-12 版本。

验证失败时会提供具体的错误位置吗?

会的第一时间指出哪个属性未通过验证,并说明具体的错误原因,例如类型不匹配或缺少必需字段。

如何限制 JSON 对象中不能出现未定义的额外属性?

您可以在 JSON Schema 中将 additionalProperties 属性设置为 false。

支持验证邮箱、URI 等特殊格式吗?

支持,您可以在 Schema 中使用 format 关键字来验证内置格式,如 email、uri 等。

校验器是否支持嵌套对象的验证?

支持,您可以通过在 Schema 的 properties 中嵌套定义 object 类型来验证任意深度的嵌套结构。

专题

自托管抽奖组件配置复核、嵌入测试与上线交付

复核转盘、刮刮卡或盲盒的配置与商家接口样例,检查可读性和移动端布局,交付版本明确的组件文件及真实浏览器验收记录。

专题

界面截图结构化、人工校对与开发交付

把一张获授权的界面截图整理为经人工校对的组件树、结构 JSON 与开发说明,记录坐标来源、识别遗漏和修改依据,不把视觉推断当成原始代码。

专题

HN 评论实体推荐票复核与榜单交付

把获准使用的 HN 评论导出整理成可追溯推荐榜单:保留语境,区分赞扬、批评和想读意向,复核争议计票,交付经过跨批次核对的结果。

专题

网站视觉样式盘点与设计令牌复核交付

采集获准公开页面,对照截图核查观察到的样式,复核颜色组合与令牌变化,交付可追溯的设计说明,不把采样结果冒充原始设计系统。

首页
工具3212
案例593
可视化471
文件查看器103
专题239
标签333
图像、音频与视频657

图像、音频、视频处理、转换与优化工具

数学、日期与金融647

计算器、数值计算、日期逻辑、统计与金融工具

设计与颜色298

颜色、版式、图形、视觉样式与设计辅助工具

文本与写作209

写作、清洗、格式化、提取与文本分析工具

开发与 Web193

开发者工具、网络处理、Web 调试与自动化辅助工具

转换与编码175

格式、文件、压缩包、单位与编码转换工具

潜客测验发布与联系人交接
讣告、悼词与纪念卡的家属复核及交付
本地习惯记录的备份、恢复演练与分享前检查
长文改编 X 串文与 LinkedIn 帖子的事实复核与交付
Markdown 互动课件审校、离线演示与交付

© 2026 Elysia Tools. 保留所有权利。

文档价格关于我们服务条款隐私政策Cookie 政策联系我们
数据格式

JSON 示例

JSON(JavaScript 对象表示法)格式示例,从简单到复杂结构

开发

Terraform Plan JSON 样本

用于依赖可视化和变更审查的 Terraform plan JSON 文件样本,贴近 terraform show -json 输出结构

数据格式

聊天记录 JSON 示例

多角色聊天记录的 JSON 示例

数据格式

富媒体 JSON 示例

常见富文本编辑器(TipTap、Quill、Slate)的 JSON 示例

Validation

身份证验证器

验证各国身份证号码的有效性并提供详细分析(JSON输出)

Web & Internet

IndieWeb ↔ Fediverse 桥接分析器

解析 microformats2(h-entry/h-card),校验 Webmention/IndieAuth/Micropub/Microsub,生成 ActivityPub Object+Activity 双视图与全回复路由 —— 严格对齐 W3C 规范

Format Conversion

BSON转换器

将数据编码/解码为BSON(Binary JSON)格式

Format Conversion

CSON转JSON

将CSON(CoffeeScript对象表示法)数据转换为JSON格式

结果

校验器自动检测数组是否为空,并验证数组内的所有商品 ID 是否唯一,输出明确的合规报告。

JSON Schema 生成器
JSON格式化
MCP Server 契约测试器(stdio + WebSocket 双传输 · JSON Schema 2020-12 工具 schema 校验)
本工具的 API 文档