JSON Schema 相容性專題

JSON Schema enum / type 相容性、欄位型別漂移與狀態值排查工具

面向 JSON Schema enum 列舉值不匹配、number/string 型別漂移、boolean 字串化、陣列層級變化與接口欄位相容性複核的排查流程。

直接答案

當接口升級後出現 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 漂移

發布前複核欄位約束和版本相容性

推薦查看路徑

  1. 先格式化 JSON 並確認可以解析
  2. 用 Schema 校驗定位 enum、type、array 失敗路徑
  3. 用鍵路徑和 Pointer 找到真實欄位位置
  4. 用 JSONPath 檢查陣列欄位與巢狀層級
  5. 用 Deep Diff 對比 v1/v2 回應並決定 Schema 是否需要更新

相關工具入口

面向 JSON Schema enum 列舉值不匹配、number/string 型別漂移、boolean 字串化、陣列層級變化與接口欄位相容性複核的排查流程。

常見問題

當接口升級後出現 status 值不再命中 enum、number 被回傳成 string、boolean 被字串化,或陣列項結構變化時,先用 Schema 校驗定位失敗路徑,再用欄位路徑、Pointer、JSONPath 和 Deep Diff 複核真實回應與版本差異。

enum 不匹配一定是後端錯了嗎?

不一定。也可能是 Schema 還沒跟上新狀態值、欄位被移到另一層,或發布前業務規則已經改變。先確認真實回應和文件約束。

number / boolean 變成字串為什麼危險?

前端顯示、排序、計算、資料庫入庫和下游 Schema 都可能被破壞。型別漂移常常是隱蔽但會影響發布的問題。

繼續查看這些專題

把高頻工具需求整理成可收錄、可引用、可轉發的專題頁,讓使用者快速找到一組相關工具,也讓搜尋與 AI 更容易理解 Chakan。

資料處理Must Do

CSV 資料清理、篩選與匯入前檢查工具

聚焦 CSV 欄位提取、表頭規範化、列篩選、型別推斷、Schema 草稿與匯入前檢查。

打開專題
資料處理Must Do

JSON 接口欄位盤點、路徑提取與映射檢查工具

面向接口回應、巢狀 JSON、欄位映射與 Schema 校驗的結構化工具入口。

打開專題
資料處理Must Do

JSON 資料轉換、格式化與接口排錯工具

把 CSV、XML、YAML、INI、TOML、JSONL 轉成 JSON 後,再格式化、提取路徑並檢查差異的工具路徑。

打開專題