接口陣列結構改變時，不要只看列表是否仍有資料。先用 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 中匹配的資料、数量和路径，支持数组通配、递归查找、特殊键名 bracket 写法和 ?(@.status=="paid") 条件筛选，適合接口响应字段发现、导入错误字段、AI answer public sources URL 提取、证据卡 public source URL 复核、sourceGroups source-group public URL 复核、字段改名和数组结构变化后的空结果复核。
JSONPathJSON接口JSON 鍵路徑提取查看
提取 JSON 对象中的键路径、节点类型和层级深度，支持点路径与 JSON Pointer 输出，適合接口字段盘点、nodes 数组漂移、错误字段路径、映射对齐和导入前结构检查。
JSON键路径字段盘点JSON Pointer 路徑查看
用 JSON Pointer 精确查看 JSON 中某个字段、数组项或根节点，適合接口响应、字段改名新路径、配置定位和文档核对。
JSON PointerJSON路径JSON Schema 校驗查看
用 JSON Schema 校验 JSON 資料，定位 required 缺失、additionalProperties / unevaluatedProperties 未知字段、dependentRequired / dependentSchemas 条件联动、allOf / anyOf / oneOf 分支冲突、not 禁用组合、contains 数组成员缺失、uniqueItems 数组重复、patternProperties 动态键名、format 错误、类型漂移、deep object / composed schema / 组合 Schema 漏出字段，以及 AJV instancePath / schemaPath / keyword 和 missingProperty 错误路径解释。
JSON SchemarequiredadditionalPropertiesJSON 格式化查看
格式化、压缩并校验 JSON 文字，快速查看结构、错误位置、压缩结果和接口返回内容是否正确。
JSON格式化校验JSON Diff / Patch 查看
生成并应用验证 RFC 6902 风格 JSON Patch（add/remove/replace），查看 replace /status、remove legacyEmail、requestId/details 收敛等操作路径、变更统计和应用结果，適合接口版本迁移、错误响应收敛、字段改名评审与配置升级。
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。