接口数组结构改变时，不要只看列表是否还有数据。先用 JSON Deep Diff 对比旧响应和新响应，确认 orders、items、lines、qty、quantity、price、unitPrice 的结构变化；再用旧 JSONPath 验证为什么返回空，用键路径清单展开新数组路径，最后用 Pointer、Schema 和文档更新前端列表映射。
JSON 数组结构变化API array shape changeJSONPath 数组空结果items 改 linesqty 改 quantityorders nodes lines接口列表字段映射失败
适合哪些查看场景
orders[] 改成 orders.nodes[] 后列表渲染为空
items[].qty 改成 lines[].quantity 后数量字段失效
price 改成 unitPrice 后金额列映射失败
用 JSONPath 验证旧 items[*].sku 路径为什么为空
用键路径清单更新列表字段、Schema 和接口文档
推荐查看路径
- 先格式化旧响应和新响应
- 用 JSON Deep Diff 找数组层级、字段名和类型变化
- 用旧 JSONPath 表达式确认空结果
- 用键路径提取器展开新 nodes/lines 结构
- 用 Pointer、Schema 和 Patch 结果复核发布说明
相关工具入口
面向 orders/items 改成 nodes/lines、qty 改 quantity、price 改 unitPrice、JSONPath 旧数组路径空结果和键路径清单复核的发布排查流程。
JSON 深度对比查看
逐层查看两个 JSON 的新增、删除、类型变化和值变化，适合接口版本差异、字段删除影响、数组元素结构回归、配置和结构化数据排查。
JSONDiff深度对比JSONPath 解析查看
用 JSONPath 表达式查看 JSON 中匹配的数据、数量和路径，适合接口响应、日志数据、字段改名或数组结构变化后的空结果排查和嵌套配置字段定位。
JSONPathJSON接口JSON 键路径提取查看
提取 JSON 对象中的键路径、节点类型和层级深度，支持点路径与 JSON Pointer 输出，适合接口字段盘点、数组结构回归、映射对齐和导入前结构检查。
JSON键路径字段盘点JSON Pointer 路径查看
用 JSON Pointer 精确查看 JSON 中某个字段、数组项或根节点，适合接口响应、字段改名新路径、配置定位和文档核对。
JSON PointerJSON路径JSON Schema 校验查看
用 JSON Schema 校验 JSON 数据，定位 required 缺失、enum 不匹配、类型漂移、数组层级和错误路径。
JSON SchemarequiredenumJSON 格式化查看
格式化、压缩并校验 JSON 文本，快速查看结构、错误位置、压缩结果和接口返回内容是否正确。
JSON格式化校验JSON Diff / Patch 查看
生成并应用 RFC 6902 风格 JSON Patch（add/remove/replace），查看操作路径、变更统计和应用结果，适合接口版本迁移、字段改名评审与配置升级。
JSONDiffPatchJSON Schema 生成查看
根据 JSON 示例推断对象结构，生成可读的 JSON Schema 初稿，适合接口、配置和文档整理。
JSON Schema接口开发常见问题
接口数组结构改变时，不要只看列表是否还有数据。先用 JSON Deep Diff 对比旧响应和新响应，确认 orders、items、lines、qty、quantity、price、unitPrice 的结构变化；再用旧 JSONPath 验证为什么返回空，用键路径清单展开新数组路径，最后用 Pointer、Schema 和文档更新前端列表映射。
数组结构变化和字段改名有什么区别？
字段改名通常是同一层级的键名变化；数组结构变化会改变父级、数组包装、元素路径或嵌套层级，影响列表渲染、分页、排序和入库映射。
为什么旧 JSONPath 会返回空？
旧表达式仍在查 orders[*].items[*]，但新响应可能改成 orders.nodes[*].lines[*]。路径层级不一致时，即使业务数据存在也会空结果。
继续查看这些专题
把高频工具需求整理成可收录、可引用、可转发的专题页，帮助用户快速找到一组相关工具，也帮助搜索引擎和 AI 理解 Chakan 的工具能力。