0

0

Python中如何处理JSON Schema?数据验证

爱谁谁

爱谁谁

发布时间:2025-07-16 16:57:02

|

1023人浏览过

|

来源于php中文网

原创

1.安装jsonschema库用于python中json schema的数据验证。2.定义描述数据结构的schema字典或json对象。3.使用validate函数验证数据是否符合schema,异常处理错误信息。4.通过enum、pattern等字段实现性别限制、手机号格式等自定义校验规则。5.在api开发中结合fastapi等框架合理使用schema校验,调试时输出详细错误路径,避免过度校验以保持灵活性。

Python中如何处理JSON Schema?数据验证

在Python中处理JSON Schema并做数据验证,主要是为了确保输入的数据符合我们定义的结构。这在API开发、配置文件解析等场景下非常有用。下面我会从几个实际需求出发,讲讲怎么用Python搞定这件事。

Python中如何处理JSON Schema?数据验证

安装依赖:先选一个好用的库

Python标准库里没有直接支持JSON Schema的模块,所以得借助第三方库。最常用的是 jsonschema 这个包,它实现了JSON Schema规范,并且使用起来非常方便。

你可以通过pip安装

立即学习Python免费学习笔记(深入)”;

Python中如何处理JSON Schema?数据验证
  • pip install jsonschema

这个库支持多个版本的Schema(比如Draft 4、6、7等),默认使用的是最新版,但也可以指定版本。


基本用法:定义Schema和验证数据

首先你得有一个Schema,它本身是一个字典或JSON对象,描述了你希望数据具备的结构和类型。

Python中如何处理JSON Schema?数据验证

比如我们要验证一个用户信息的数据结构:

schema = {
    "type": "object",
    "properties": {
        "name": {"type": "string"},
        "age": {"type": "number"},
        "email": {"type": "string", "format": "email"}
    },
    "required": ["name", "age"]
}

然后是待验证的数据:

动态WEB网站中的PHP和MySQL:直观的QuickPro指南第2版
动态WEB网站中的PHP和MySQL:直观的QuickPro指南第2版

动态WEB网站中的PHP和MySQL详细反映实际程序的需求,仔细地探讨外部数据的验证(例如信用卡卡号的格式)、用户登录以及如何使用模板建立网页的标准外观。动态WEB网站中的PHP和MySQL的内容不仅仅是这些。书中还提到如何串联JavaScript与PHP让用户操作时更快、更方便。还有正确处理用户输入错误的方法,让网站看起来更专业。另外还引入大量来自PEAR外挂函数库的强大功能,对常用的、强大的包

下载
data = {
    "name": "Alice",
    "age": 25,
    "email": "alice@example.com"
}

接下来就可以调用验证函数了:

from jsonschema import validate, ValidationError

try:
    validate(instance=data, schema=schema)
except ValidationError as e:
    print(f"验证失败: {e}")

如果数据没问题就不会抛异常。如果有字段缺失或者类型不对,就会抛出 ValidationError


高级技巧:自定义校验规则和错误提示

有时候内置的校验规则不够用,比如你想检查某个字段是否在特定枚举值中,或者满足某种正则表达式,这时候可以在schema里加更详细的约束。

比如限制性别只能是“male”或“female”:

"gender": {"type": "string", "enum": ["male", "female"]}

再比如手机号格式可以用正则:

"phone": {"type": "string", "pattern": "^1[3-9]\\d{9}$"}

此外,还可以通过添加 message 字段来自定义错误信息,虽然 jsonschema 默认不支持,但可以通过封装逻辑来实现更友好的提示。


实际应用建议:在项目中如何合理使用

  • 用于API请求参数校验:在接受外部请求时,提前定义好schema可以有效拦截非法输入。
  • 配合FastAPI等框架使用更好:像FastAPI本身就集成了Pydantic,对schema的支持更完善,适合大型项目。
  • 调试时输出详细错误信息:捕获 ValidationError 后,可以通过 .message.absolute_path 看到具体哪里出错了。
  • 不要过度校验:有些字段可选就设为可选,别硬塞必填项,否则反而影响灵活性。

基本上就这些。掌握这几个点,就能在日常开发中轻松应对大部分JSON数据结构校验的需求了。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

715

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

625

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

739

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

617

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1235

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

547

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

575

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

698

2023.08.11

小游戏4399大全
小游戏4399大全

4399小游戏免费秒玩大全来了!无需下载、即点即玩,涵盖动作、冒险、益智、射击、体育、双人等全品类热门小游戏。经典如《黄金矿工》《森林冰火人》《狂扁小朋友》一应俱全,每日更新最新H5游戏,支持电脑与手机跨端畅玩。访问4399小游戏中心,重温童年回忆,畅享轻松娱乐时光!官方入口安全绿色,无插件、无广告干扰,打开即玩,快乐秒达!

30

2025.12.31

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 6.3万人学习

Git 教程
Git 教程

共21课时 | 2.3万人学习

Django 教程
Django 教程

共28课时 | 2.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号