当前位置：首页 > news >正文

JSON Schema 高效校验 JSON 数据格式

news 来源：原创 2025/7/27 1:30:10

在数据交换和API开发中，JSON 已成为最流行的数据格式之一。但你是否遇到过这些困扰？

接收的JSON字段缺失关键数据？
数值类型意外变成了字符串？
嵌套结构不符合预期？

JSON Schema 正是解决这些问题的利器。本文将带你全面掌握这个结构化校验工具。

一、为什么需要 JSON Schema？

1.1 数据验证的必要性

确保API请求/响应格式规范
验证配置文件完整性
防止无效数据进入数据库
提升不同系统间的协作效率

1.2 传统验证方式的局限

// 手工验证示例
function validateUser(user) {if (!user.name) throw "缺少姓名";if (typeof user.age !== 'number') throw "年龄必须是数字";// 更多验证条件...
}

手工编写验证逻辑存在：

重复劳动
难以维护
无法复用
容易遗漏边界情况

二、JSON Schema 基础入门

2.1 Schema 结构剖析

{"$schema": "https://json-schema.org/draft/2020-12/schema","title": "用户信息","description": "用户基本信息验证","type": "object","properties": {"name": {"type": "string","minLength": 2,"maxLength": 20},"age": {"type": "integer","minimum": 18,"maximum": 120}},"required": ["name"],"additionalProperties": false
}

2.2 核心验证关键字

关键字	作用	示例值
`type`	数据类型	“string”, “array”
`format`	数据格式校验	“email”, “date-time”
`enum`	枚举值校验	[1, 2, 3]
`minimum`/`maximum`	数值范围限制	0, 100
`minLength`/`maxLength`	字符串长度限制	5, 20
`pattern`	正则表达式匹配	“^\d{3}-\d{4}$”
`items`	数组元素约束	{ “type”: “number” }
`required`	必须字段列表	[“id”, “name”]
`additionalProperties`	是否允许额外属性	false

三、实战：从简单到复杂 Schema

3.1 基础类型验证

{"type": "object","properties": {"email": {"type": "string","format": "email"},"score": {"type": "number","exclusiveMinimum": 0,"exclusiveMaximum": 100}}
}

3.2 嵌套结构验证

{"type": "object","properties": {"address": {"type": "object","properties": {"street": { "type": "string" },"city": { "type": "string" },"coordinates": {"type": "array","items": {"type": "number"},"minItems": 2,"maxItems": 2}},"required": ["street", "city"]}}
}

3.3 条件校验

{"if": {"properties": { "member": { "const": true } }},"then": {"required": ["membership_id"]}
}

四、校验实现

4.1 Java 示例

Schema schema = SchemaLoader.load(new File("schema.json")); //或yml配置文件读取
JSONObject json = new JSONObject("{ \"username\": \"john\", \"email\": \"john@example.com\" }");
schema.validate(json); // 抛出 ValidationException 异常

4.2 JavaScript 示例

const Ajv = require('ajv');
const ajv = new Ajv();const schema = {type: 'object',properties: {timestamp: { type: 'string',format: 'date-time'}}
};const validate = ajv.compile(schema);
const valid = validate({timestamp: "2023-07-20T12:34:56Z"});if (!valid) console.log(validate.errors);

五、最佳实践与调试技巧

5.1 开发建议

版本声明：始终包含 $schema 声明
渐进式校验：先验证基础结构，再添加复杂约束
复用定义：使用 $defs 重用公共模式
文档注释：善用 title 和 description

5.2 常见错误排查

// 错误示例
{"error": "invalid_type","message": "预期 string 类型，实际收到 number","path": "/contact/phone"
}

调试步骤：

检查错误路径对应的Schema定义
确认类型声明与数据实际类型
验证正则表达式等复杂约束
使用在线验证器测试

六、扩展工具生态

工具类型	推荐工具
在线验证器	JSON Schema Validator
IDE插件	VSCode JSON Schema插件
可视化工具	JSON Schema Viewer
生成工具	从JSON生成Schema的工具

结语

JSON Schema 不仅是一个验证工具，更是数据契约的载体。通过：

95% 的接口数据问题可以在开发阶段发现
减少70%的数据校验代码量
提升跨团队协作效率

掌握它，让你的JSON数据处理更加专业可靠！

小贴士：最新的 2020-12 版本支持条件组合、锚点引用等高级特性，建议新项目优先采用该版本标准。

JSON Schema 高效校验 JSON 数据格式

在数据交换和API开发中，JSON 已成为最流行的数据格式之一。但你是否遇到过这些困扰？ 接收的JSON字段缺失关键数据？数值类型意外变成了字符串？嵌套结构不符合预期？ JSON Schema 正是解决这些问题的利器。本文将带你全…...

编程日记 2025/7/27 1:30:10

机器学习09-正规方程

机器学习笔记：正规方程（Normal Equation） 概述正规方程是线性回归中求解参数的一种解析方法。它基于最小化损失函数（如最小二乘法）来直接计算出参数的最优值。在机器学习中，这种方法尤其适用于特征数量不…...

编程日记 2025/7/27 18:51:59

Java大师成长计划之第26天：Spring生态与微服务架构之消息驱动的微服务

📢 友情提示： 本文由银河易创AI（https://ai.eaigx.com）平台gpt-4-turbo模型辅助创作完成，旨在提供灵感参考与技术分享，文中关键数据、代码与结论建议通过官方渠道验证。在现代微服务架构中，服务…...

编程日记 2025/7/27 18:27:40

Linux 文件(1)

1. 文件 1.1 文件是什么一个文件，是由其文件属性与文件内容构成的。文件属性又称为一个文件的元数据，因此如果一个文件，内容为空，这个文件依然要占据磁盘空间。 1.2 文件在哪里一个文件，如果没有被打开&#xff…...

编程日记 2025/7/27 15:51:59

程序代码篇---python向http界面发送数据

文章目录前言前言本文简单接受了python向http界面发送数据...

编程日记 2025/7/25 10:51:45

【iOS】探索消息流程

探索消息流程 Runtime介绍OC三大核心动态特性动态类型动态绑定动态语言方法的本质代码转换objc_msgSendSELIMPMethod 父类方法在子类中的实现消息查找流程开始查找快速查找流程慢速查找流程二分查找方法列表父类缓存查找动态方法解析动态方法决议实例方法类方法优化消息转发…...

编程日记 2025/7/27 18:43:26

院校机试刷题第六天：1134矩阵翻转、1052学生成绩管理、1409对称矩阵

一、1134矩阵翻转 1.题目描述 2.解题思路很简单的模拟题，甚至只是上下翻转，遍历输出的时候先把最下面那一行输出即可。 3.代码 #include <iostream> #include <vector> using namespace std;int main() {int n;cin >> n;vector&l…...

编程日记 2025/7/27 0:39:08

DeepSeek在简历筛选系统中的深度应用

一、多模态解析引擎的技术突破 1.1 复杂格式的精准解析针对简历格式多样性挑战，DeepSeek采用三级解析架构：格式标准化层：基于Transformer的DocParser模型支持200+种文档格式转换视觉特征提取：使用改进的YOLOv8进行证书印章识别（mAP@0.5达93.7%）语义重构模块：通过注意…...

编程日记 2025/7/27 18:51:26

c++多线程debug

debug demo 命令行查看 ps -eLf|grep cam_det //查看当前运行的轻量级进程 ps -aux | grep 执行文件 //查看当前运行的进程 ps -aL | grep 执行文件 //查看当前运行的轻量级进程 pstree -p 主线程ID //查看主线程和新线程的关系查看线程栈结构 pstack 线程ID 步骤&…...

编程日记 2025/7/19 5:07:08

【回溯剪支状态压缩】# P10419 [蓝桥杯 2023 国 A] 01 游戏|普及+

本文涉及知识点 C回溯位运算、状态压缩、枚举子集汇总 P10419 [蓝桥杯 2023 国 A] 01 游戏题目描述小蓝最近玩上了 01 01 01 游戏，这是一款带有二进制思想的棋子游戏，具体来说游戏在一个大小为 N N N\times N NN 的棋盘上进行，棋盘…...

编程日记 2025/7/27 1:48:47

CUDA 纹理入门

一、什么是CUDA纹理 CUDA纹理是NVIDIA GPU提供的一种特殊内存访问机制，它允许高效地访问和过滤结构化数据。纹理内存最初是为图形渲染设计的，但在通用计算(GPGPU)中也很有用。二、纹理内存的优势缓存优化：纹理内存有专用的缓存，适合空间局部性好的访问模式硬件过滤：支…...

编程日记 2025/7/26 14:51:35

大模型微调步骤整理

在对深度学习模型进行微调时，我通常会遵循以下几个通用步骤。第一步是选择一个合适的预训练模型。PyTorch 的 torchvision.models 模块提供了很多经典的预训练模型，比如 ResNet、VGG、EfficientNet 等。我们可以直接使用它们作为模型的基础结构。例如，加载一个预训练的 Re…...

编程日记 2025/7/25 19:02:26

【GPT入门】第39课 OPENAI官方API调用方法

【GPT入门】第39课 OPENAI官方API调用方法 1. OPENAI 免费API2. openai调用最简单的API3.apiKey提取到环境变量 1. OPENAI 免费API 需要科学上网，可以调用 gpt-4o-mini 的 api, 使用其它旧的GPT，反而可能需要收费，例如 gpt-3.5-turbo 2. op…...

编程日记 2025/7/27 4:45:02

【DeepSeek论文精读】11. 洞察 DeepSeek-V3：扩展挑战和对 AI 架构硬件的思考

欢迎关注[【AIGC论文精读】](https://blog.csdn.net/youcans/category_12321605.html）原创作品【DeepSeek论文精读】1. 从 DeepSeek LLM 到 DeepSeek R1 【DeepSeek论文精读】7. DeepSeek 的发展历程与关键技术【DeepSeek论文精读】11. 洞察 DeepSeek-V3&#xff…...

编程日记 2025/7/27 8:25:12

MySQL事务的一些奇奇怪怪知识

Gorm事务有error却不返回会发生什么 Gorm包是大家比较高频使用。正常的用法是，如果有失败返回error，整体rollback，如果不返回error则commit。下面是Transaction的源码： // Transaction start a transaction as a block, return …...

编程日记 2025/7/26 17:45:38

C语言内存函数与数据在内存中的存储

一、c语言内存函数 1、memcpy函数是一个标准库函数，用于内存复制。功能上是用来将一块内存中的内容复制到另一块内存中。用户需要提供目标地址、源地址以及要复制的字节数。例如结构体之间的复制。 memcpy函数的原型是：void* memcpy（void* …...

编程日记 2025/7/15 20:06:40

Power BI Desktop运算符和新建列

1.运算符运算符含义加 - 减 * 乘 / 除 ^ 幂运算符含义等于 > 大于 < 小于 > 大于等于 < 小于等于 <> 不等于运算符含义 && 与 || 或 not 非 & 字符串连接 in 包含 not in 不包含 2.新建列 …...

编程日记 2025/7/25 21:13:48

windows 安装gdal实现png转tif，以及栅格拼接

windows 安装gdal实现png转tif，以及栅格拼接一、安装gdal 网上有很多安装gdal的方法，此处通过osgeo4w安装gdal 1.下载osgeo4w 下载地址 https://trac.osgeo.org/osgeo4w/ 2、安装osgeo4w exe文件安装，前面部分很简单，就不再…...

编程日记 2025/7/26 1:35:54

【嵙大o】C++作业合集

参考： C swap（交换）函数指针/引用/C自带-CSDN博客 Problem IDTitleCPP指针CPP引用1107 Problem A编写函数：Swap (I) (Append Code)1158 Problem B整型数据的输出格式1163 Problem C时间：24小时制转12小时制1205…...

编程日记 2025/7/26 1:28:13

论信息系统项目的采购管理

论信息系统项目的采购管理背景一、规划采购管理二、实施采购三、控制采购结语背景某市为对扶贫对象实施精确识别、精确帮扶、精确管理，决定由民政部门牵头，建设家庭经济状况分析及市、县（区）、镇（街）三级…...

编程日记 2025/7/24 8:48:56

创建型：单例模式

目录 1、核心思想 2、实现方式 2.1 饿汉式 2.2 懒汉式 2.3 枚举（Enum） 3、关键注意事项 3.1 线程安全 3.2 反射攻击 3.3 序列化与反序列化 3.4 克隆保护 4、适用场景 1、核心思想目的：确保一个类仅有一个实例功能：…...

编程日记 2025/7/23 22:15:24

职场方法论总结（4）-如何正确地汇报

一、明确汇报目标区分类型：是项目进展汇报？数据总结？问题解决方案？还是资源申请？明确目标才能聚焦内容。听众需求： 所有人都希望你用最简短的语言把事情讲清楚，节省时间领导关注结果、风险和资…...

编程日记 2025/7/23 20:40:51

STM32SPI实战-Flash模板

STM32SPI实战-Flash模板一，常用指令集（部分）二，组件库GD25QXX API 函数解析1,前提条件2,初始化与识别1, void spi_flash_init(void)2, uint32_t spi_flash_read_id(void) 3,擦除操作1, void spi_flash_sector_erase(uint32_t sec…...

编程日记 2025/7/25 0:38:48

CSS- 4.4 固定定位（fixed）咖啡售卖官网实例

本系列可作为前端学习系列的笔记，代码的运行环境是在HBuilder中，小编会将代码复制下来，大家复制下来就可以练习了，方便大家学习。 HTML系列文章已经收录在前端专栏，有需要的宝宝们可以点击前端专栏查看！ 点…...

编程日记 2025/7/22 8:00:46

【Retinanet】训练自己的数据集

目录 1.下载源码2.配置环境3.数据集准备4.训练自己的数据5.成功训练！ 1.下载源码 Retinanet代码：代码下载到你的目录中，进行打开。 2.配置环境这里就是cudapytorch，没有配置过的可以参考博客： 深度学习环境的搭建…...

编程日记 2025/7/26 11:38:55

微软将于 8 月 11 日关闭 Bing Search API 服务

微软宣布将于 2025 年 8 月 11 日正式关闭 Bing Search API 服务。届时，所有使用 Bing Search API 的实例将完全停用，同时不再接受新用户注册。此次停用决定主要影响 Bing Search F1 及 S1 到 S9 资源的用户，以及 Custom Search F0 与 S1 到…...

编程日记 2025/7/25 21:33:20

探索 Python 的利器：help()、dir() 与 AI 工具的结合应用

引言在编程世界中，Python 以其简洁的语法、强大的功能和丰富的库生态系统成为众多开发者的首选语言。无论是初学者还是资深工程师，在学习新模块、调试代码或探索未知功能时，常常需要有效的工具来帮助理解和解决问题。Python 提供了内置的 help() 和 dir() 函数，让开发者能…...

编程日记 2025/7/27 8:31:40

MySQL查询优化器底层原理解析：从逻辑优化到物理优化

MySQL查询优化器底层原理解析：从逻辑优化到物理优化引言在数据库系统中，SQL语句的执行效率直接影响着整个应用的性能表现。一条普通的SQL执行前会经历五个关键阶段：SQL输入、语法分析、语义检查、SQL优化、SQL执行。其中，SQL优…...

编程日记 2025/7/27 8:25:17

UI架构的历史与基础入门

本笔记的目的是通过一系列连贯的例子来探讨“事物-模型-视图-编辑器”这一隐喻。这些例子都来自我的规划系统（planning system），用于解释上述四个概念。所有例子都已实现，但并未在本文描述的清晰类结构中实现。这些隐喻对应于《…...

编程日记 2025/7/27 10:29:32

（三）MMA（KeyCloak身份服务器/OutBox Pattern）

文章目录项目地址一、KeyCloak二、OutBox Pattern2.1 配置Common模块的OutBox1. OutboxMessage2. 数据库配置OutboxMessageConfiguration3. 创建Save前的EF拦截器4. 创建Quartz后台任务5. 配置后台任务6. 注册服务2.2 创建OutBox的消费者项目地址教程作者：教程地址：代码仓库…...

编程日记 2025/7/25 16:32:23

【通用智能体】Playwright：跨浏览器自动化工具

Playwright：跨浏览器自动化工具一、Playwright 是什么？二、应用场景及案例场景 1：端到端（E2E）测试场景 2：UI 自动化（表单批量提交）场景 3：页面截图与 PDF 生成场景 4&am…...

编程日记 2025/7/22 6:19:38

单片机设计_停车场车位管理系统（AT89C52、LCD1602）

想要更多项目私wo!!! 一、电路设计此电路由AT89C52单片机和LCD1602液晶显示模块等器件组成。二、运行结果三、部分代码 #include <reg52.h> //调用单片机头文件 #define uchar unsigned char //无符号字符型宏定义变量范围0~255 #define uint unsigned…...

编程日记 2025/7/24 23:45:57

【android bluetooth 协议分析 01】【HCI 层介绍 5】【SetEventMask命令介绍】

1. HCI_Set_Event_Mask 命令作用项目内容命令名HCI_Set_Event_MaskOCF0x0001作用主机通过设置 Event Mask 告诉控制器：我只对某些事件感兴趣，屏蔽其他事件，以减少中断。事件来源事件是 HCI 与主机之间通信的反馈机制，控制器通过…...

编程日记 2025/7/25 1:07:56

python打卡day29

类的装饰器知识点回顾类的装饰器装饰器思想的进一步理解：外部修改、动态类方法的定义：内部定义和外部定义回顾一下，函数的装饰器是 ：接收一个函数，返回一个修改后的函数。类也有修饰器，类装饰器本质上确…...

编程日记 2025/7/14 19:07:11

【数据结构】树状数组

树状数组假设一个数可以 x x x可以被二进制分解成 x 2 i 1 2 i 2 . . . 2 i m x 2^{i_1} 2^{i_2} ... 2^{i_m} x2i12i2...2im，不妨设 i 1 > i 2 > . . . > i m i_1 > i_2 > ... > i_m i1>i2>...>im，进…...

编程日记 2025/7/27 4:49:16

Java虚拟机 - JVM与Java体系结构

Java虚拟机 JVM与Java体系结构为什么要学习JVMJava与JVM简介Java 语言的核心特性JVM：Java 生态的基石JVM的架构模型基于栈的指令集架构（Stack-Based）基于寄存器的指令集架构（Register-Based）JVM生命周期总结 JVM与Jav…...

编程日记 2025/7/26 12:51:28

翻译题文章目录翻译题一带一路中国结一带一路 The “One Belt and One Road” Initiative aims to achieve win-win and shared development. China remains unchanged in its commitment to foster partnerships. China pursues an independent foreign policy of peace, …...

编程日记 2025/7/23 15:45:08

SparkSQL基本操作

以下是 Spark SQL 的基本操作总结，涵盖数据读取、转换、查询、写入等核心功能： 一、初始化 SparkSession scala import org.apache.spark.sql.SparkSession val spark SparkSession.builder() .appName("Spark SQL Demo") .master("…...

编程日记 2025/7/25 17:03:48

Ansible模块——文件内容修改

修改文件单行内容 ansible.builtin.lineinfile 可以按行修改文件内容，一次修改一行，支持正则表达式。选项名类型默认值描述 attributesstrnull 设置目标文件的 Linux 文件系统属性（attribute bits），作用类似于…...

编程日记 2025/7/27 1:30:06

基于单片机路灯自动控制仪仿真设计

标题:基于单片机路灯自动控制仪仿真设计内容:1.摘要本设计旨在解决传统路灯控制方式效率低、能耗大的问题，开展了基于单片机的路灯自动控制仪仿真设计。采用单片机作为核心控制单元，结合光照传感器、时钟模块等硬件，运用相关软件进行编程和…...

编程日记 2025/7/26 7:44:57

Spring Web MVC————入门(3)

今天我们来一个大练习，我们要实现一个登录界面，登录进去了先获取到登录人信息，可以选择计算器和留言板两个功能，另外我们是学后端的，对于前端我们会些基础的就行了，知道ajax怎么用，知道怎么关联…...

编程日记 2025/7/21 5:59:50

拓展运算符与数组解构赋值的区别

拓展运算符与数组解构赋值是ES6中用于处理数组的两种不同的特性，它们有以下区别： 概念与作用 • 拓展运算符：主要用于将数组展开成一系列独立的元素，或者将多个数组合并为一个数组，以及在函数调用时将数组作为可变参…...

编程日记 2025/7/22 23:54:34

【Linux】第二十章管理基本存储

目录 1. 对 Linux 磁盘进行分区时有哪两种方案？分别加以详细说明。 2. 简单说下创建MBR磁盘分区涉及哪几个步骤？ 3. 创建GPT分区与创建MBR分区有什么不同？ 4. 在创建分区时就会在分区上创建文件系统吗？ 5. 如何持久挂载文件系…...

编程日记 2025/7/27 3:53:08

DeepSeek本地部署全攻略：从零搭建到Web可视化及数据训练

目录 1. 环境准备与硬件要求2. 安装Ollama框架3. 部署DeepSeek模型4. Web可视化配置5. 数据投喂与模型训练6. 进阶技巧与常见问题1. 环境准备与硬件要求硬件配置建议基础配置：16GB内存 + RTX 3060显卡（流畅运行7B参数模型）进阶配置：32GB内存 + RTX 4090显卡（支持14B模型…...

编程日记 2025/7/25 14:29:40

JavaScript性能优化实战（12）：大型应用性能优化实战案例

在前面的系列文章中，我们探讨了各种JavaScript性能优化技术和策略。本篇将聚焦于实际的大型应用场景，通过真实案例展示如何综合运用这些技术，解决复杂应用中的性能挑战。目录电商平台首屏加载优化全流程复杂数据可视化应用性能优化案例在线协作工具的实时响应优化移动端W…...

编程日记 2025/7/22 5:25:37

前缀和——中心数组下标

此题我们不应局限于前缀和的模板，因为该中心下标把数组分为两个部分且每个部分都要求和，我们就一个再创建一个”后缀和” 定义两个数组f，g。f[i]表示[0,i-1]所有元素的和 f[i]f[i-1]nums[i-1];g[i]表示[i1,n-1]的和 g[i]g[i1]nums[i1];因为依…...

编程日记 2025/7/23 10:46:06

Java——创建多线程的四种方式

一、继承Thread 步骤 1.定义一个类继承Thread 2.重写run方法，在方法中设置线程任务（此线程具体执行的代码） 3.创建自定义线程类对象 4.调用Thread中的start方法，开启线程，jvm自动调用run方法常用方法 void sta…...

编程日记 2025/7/25 12:17:05

广域网学习

PPPoE技术（拨号上网） PPPoE （ PPP over Ethernet ，以太网承载 PPP 协议）是一种把 PPP 帧封装到以太网帧中的链路层协议。 PPPoE 可以使以太网网络中的多台主机连接到远端的宽带接入服务器。应用场景 PPPoE 组网结构采…...

编程日记 2025/7/25 23:15:18

inverse-design-of-grating-coupler-3d

一、设计和优化3D光栅耦合器 1.1 代码讲解通过预定义的环形间距参数（distances数组），在FDTD中生成椭圆光栅结构，并通过用户交互确认几何正确性后，可进一步执行参数扫描优化。 # os：用于操作系统相关功能（如文件路径操作） import os import sys# lumapi：Lumerical 的…...

编程日记 2025/7/23 22:11:03

渗透测试流程-中篇

#作者：允砸儿 #日期：乙巳青蛇年四月廿一（2025年5月18日） 今天笔者带大家继续学习，网安的知识比较杂且知识面很广，这一部分会介绍很多需要使用的工具。会用各种工具是做网安的基础，ok咱们继续…...

编程日记 2025/7/26 8:39:19