Schema 陣列約束專題

JSON Schema not / contains 陣列約束調試與發布前校驗工具

面向 not 禁用組合、contains 陣列成員約束、生產測試模式攔截、角色陣列校驗與 API 發布前 Schema 複核的本地排查流程。

直接答案

當 Schema 需要禁止某種欄位組合,或要求陣列裡至少有一個符合條件的物件時,用 not 和 contains 表達規則,再用本地 JSON Schema 校驗查看錯誤 keyword 與路徑。not 適合禁止 production + testMode=true 這類危險組合;contains 適合要求 roles 中至少存在 active admin 或 features 中至少包含 billing。

覆蓋的長尾搜尋詞
JSON Schema notJSON Schema contains陣列約束調試contains 陣列成員not 禁用欄位組合production testMode SchemaJSON Schema array constraint

適合哪些查看場景

禁止 production 與 testMode=true 同時出現

確認 features 陣列缺少 billing

檢查角色陣列是否至少有一個 active admin

定位 contains 沒匹配到任何陣列成員

發布前複核禁用組合與陣列成員規則

推薦查看路徑

  1. 先格式化 Schema 和 JSON 樣本
  2. 把禁用組合寫進 not 並補 required
  3. 把陣列成員要求寫進 contains
  4. 執行 Schema 校驗查看 keyword 和 instancePath
  5. 用 JSONPath、Pointer 和 Deep Diff 複核陣列結構是否變化

相關工具入口

面向 not 禁用組合、contains 陣列成員約束、生產測試模式攔截、角色陣列校驗與 API 發布前 Schema 複核的本地排查流程。

JSON Schema 校驗查看

用 JSON Schema 校验 JSON 資料,定位 required 缺失、additionalProperties 未知字段、dependentRequired 依赖必填、allOf / anyOf / oneOf 分支冲突、not 禁用组合、contains 数组成员缺失、uniqueItems 数组重复、patternProperties 动态键名、format 错误、类型漂移、数组层级和错误路径。

JSON SchemarequiredadditionalProperties

JSON Schema 生成查看

根据 JSON 示例推断对象结构,生成可读的 JSON Schema 初稿,適合接口、配置和文档整理。

JSON Schema接口开发

JSON 鍵路徑提取查看

提取 JSON 对象中的键路径、节点类型和层级深度,支持点路径与 JSON Pointer 输出,適合接口字段盘点、数组结构回归、映射对齐和导入前结构检查。

JSON键路径字段盘点

JSON Pointer 路徑查看

用 JSON Pointer 精确查看 JSON 中某个字段、数组项或根节点,適合接口响应、字段改名新路径、配置定位和文档核对。

JSON PointerJSON路径

JSONPath 解析查看

用 JSONPath 表達式查看 JSON 中匹配的資料、数量和路径,支持数组通配、递归查找和 ?(@.status=="paid") 这类条件筛选,適合接口响应、日志資料、字段改名或数组结构变化后的空结果排查。

JSONPathJSON接口

JSON 深度對比查看

逐层查看两个 JSON 的新增、删除、类型变化和值变化,適合接口版本差异、字段删除影响、数组元素结构回归、配置和結構化資料排查。

JSONDiff深度对比

JSON 格式化查看

格式化、压缩并校验 JSON 文字,快速查看结构、错误位置、压缩结果和接口返回内容是否正确。

JSON格式化校验

常見問題

當 Schema 需要禁止某種欄位組合,或要求陣列裡至少有一個符合條件的物件時,用 not 和 contains 表達規則,再用本地 JSON Schema 校驗查看錯誤 keyword 與路徑。not 適合禁止 production + testMode=true 這類危險組合;contains 適合要求 roles 中至少存在 active admin 或 features 中至少包含 billing。

not 和 contains 分別解決什麼問題?

not 用來禁止某個子 Schema 匹配,常見於危險欄位組合;contains 用來要求陣列中至少有一個元素符合指定條件。

這些示例會上傳接口資料嗎?

不會。Schema 校驗在瀏覽器本地執行,sitemap 只收錄短 demo 示例,不收錄使用者輸入。

繼續查看這些專題

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

資料處理Must Do

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

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

打開專題
資料處理Must Do

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

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

打開專題
資料處理Must Do

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

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

打開專題