当接口升级后出现 status 值不再命中 enum、number 被返回成 string、boolean 被字符串化，或数组项结构变化时，先用 Schema 校验定位失败路径，再用字段路径、Pointer、JSONPath 和 Deep Diff 复核真实响应与版本差异。
JSON Schema enum 错误JSON Schema type mismatchJSON number string 类型漂移JSON boolean stringAPI 字段类型变化JSON Schema 兼容性enum 值不匹配接口版本字段约束
适合哪些查看场景
接口 status 从 draft/published 变成 processing，触发 enum 校验失败
orderId、total、paid 被后端序列化成字符串
数组 items 的元素结构升级后，旧 Schema 不再兼容
排查前后端约定的 number、integer、boolean 漂移
发布前复核字段约束和版本兼容性
推荐查看路径
- 先格式化 JSON 并确认可以解析
- 用 Schema 校验定位 enum、type、array 失败路径
- 用键路径和 Pointer 找到真实字段位置
- 用 JSONPath 检查数组字段和嵌套层级
- 用 Deep Diff 对比 v1/v2 响应并决定 Schema 是否要更新
相关工具入口
面向 JSON Schema enum 枚举值不匹配、number/string 类型漂移、boolean 字符串化、数组层级变化和接口字段兼容性复核的开发排查流程。
JSON Schema 校验查看
用 JSON Schema 校验 JSON 数据，定位 required 缺失、enum 不匹配、类型漂移、数组层级和错误路径。
JSON SchemarequiredenumJSON Schema 生成查看
根据 JSON 示例推断对象结构，生成可读的 JSON Schema 初稿，适合接口、配置和文档整理。
JSON Schema接口开发JSON 键路径提取查看
提取 JSON 对象中的键路径、节点类型和层级深度，支持点路径与 JSON Pointer 输出，适合接口字段盘点、映射对齐和导入前结构检查。
JSON键路径字段盘点JSON Pointer 路径查看
用 JSON Pointer 精确查看 JSON 中某个字段、数组项或根节点，适合接口响应、配置定位和文档核对。
JSON PointerJSON路径JSON 深度对比查看
逐层查看两个 JSON 的新增、删除、类型变化和值变化，适合接口版本差异、字段删除影响、数组结构变化、配置和结构化数据排查。
JSONDiff深度对比JSON 格式化查看
格式化、压缩并校验 JSON 文本，快速查看结构、错误位置、压缩结果和接口返回内容是否正确。
JSON格式化校验JSONPath 解析查看
用 JSONPath 表达式查看 JSON 中匹配的数据、数量和路径，适合接口响应、日志数据和嵌套配置字段定位。
JSONPathJSON接口常见问题
当接口升级后出现 status 值不再命中 enum、number 被返回成 string、boolean 被字符串化，或数组项结构变化时，先用 Schema 校验定位失败路径，再用字段路径、Pointer、JSONPath 和 Deep Diff 复核真实响应与版本差异。
enum 不匹配一定是后端错了吗？
不一定。也可能是 Schema 还没跟上新状态值、字段被迁移到另一层、或发布前业务规则已经变更。先确认真实响应和文档约束。
number / boolean 变成字符串为什么危险？
前端显示、排序、计算、数据库入库和下游 Schema 都可能被破坏。特别是金额、状态和开关字段，类型漂移往往会造成隐蔽兼容性问题。
继续查看这些专题
把高频工具需求整理成可收录、可引用、可转发的专题页，帮助用户快速找到一组相关工具，也帮助搜索引擎和 AI 理解 Chakan 的工具能力。