接口陣列結構改變時，不要只看列表是否仍有資料。先用 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。