当接口字段需要二选一、支付方式互斥、联系方式必须是 email 或 URL 时，只检查 required 和 type 不够。先用 JSON Schema 校验 oneOf、const、additionalProperties 和 format，再用键路径、JSON Pointer、JSONPath 和 Deep Diff 核对真实响应，确认 Schema 是过严、过旧，还是接口数据真的不兼容。
JSON Schema oneOf 校验JSON Schema format 错误email format 校验uri format 校验互斥字段校验oneOf 分支冲突API Schema 兼容性
适合哪些查看场景
payment.method=card 却传入 bankAccount 导致 oneOf 分支都不匹配
email、callbackUrl、date-time format 在发布前失效
互斥字段同时出现导致表单或接口校验失败
用键路径确认联系方式字段真实位置
对比 v1/v2 响应决定 Schema 是否要放宽或升级
推荐查看路径
- 先格式化 Schema 和 JSON 样例
- 用 Schema 校验 oneOf、const、required、additionalProperties 和 format
- 查看错误路径和 keyword，判断是分支冲突还是格式错误
- 用键路径、Pointer 和 JSONPath 复核真实字段位置
- 用 Deep Diff 对比版本变化并更新接口文档
相关工具入口
面向 oneOf 条件分支冲突、互斥字段、const 规则、email/uri/date format 错误和接口发布前 Schema 兼容性复核的排查流程。
JSON Schema 校验查看
用 JSON Schema 校验 JSON 数据，定位 required 缺失、enum 不匹配、oneOf 分支冲突、format 错误、类型漂移、数组层级和错误路径。
JSON SchemarequiredenumJSON Schema 生成查看
根据 JSON 示例推断对象结构，生成可读的 JSON Schema 初稿，适合接口、配置和文档整理。
JSON Schema接口开发JSON 键路径提取查看
提取 JSON 对象中的键路径、节点类型和层级深度，支持点路径与 JSON Pointer 输出，适合接口字段盘点、数组结构回归、映射对齐和导入前结构检查。
JSON键路径字段盘点JSON Pointer 路径查看
用 JSON Pointer 精确查看 JSON 中某个字段、数组项或根节点，适合接口响应、字段改名新路径、配置定位和文档核对。
JSON PointerJSON路径JSONPath 解析查看
用 JSONPath 表达式查看 JSON 中匹配的数据、数量和路径，适合接口响应、日志数据、字段改名或数组结构变化后的空结果排查和嵌套配置字段定位。
JSONPathJSON接口JSON 深度对比查看
逐层查看两个 JSON 的新增、删除、类型变化和值变化，适合接口版本差异、字段删除影响、数组元素结构回归、配置和结构化数据排查。
JSONDiff深度对比JSON 格式化查看
格式化、压缩并校验 JSON 文本，快速查看结构、错误位置、压缩结果和接口返回内容是否正确。
JSON格式化校验常见问题
当接口字段需要二选一、支付方式互斥、联系方式必须是 email 或 URL 时，只检查 required 和 type 不够。先用 JSON Schema 校验 oneOf、const、additionalProperties 和 format，再用键路径、JSON Pointer、JSONPath 和 Deep Diff 核对真实响应，确认 Schema 是过严、过旧，还是接口数据真的不兼容。
oneOf 和 anyOf 有什么区别？
oneOf 要求数据只匹配一个分支；anyOf 允许匹配一个或多个分支。支付方式、互斥字段和单一业务类型通常更适合先用 oneOf 检查。
format 错误一定代表数据不能用吗？
不一定。format 是发布前初筛信号。需要结合业务规则确认是否要严格要求 email、uri、date-time 或 uuid 格式。
继续查看这些专题
把高频工具需求整理成可收录、可引用、可转发的专题页，帮助用户快速找到一组相关工具，也帮助搜索引擎和 AI 理解 Chakan 的工具能力。