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 错误路径解释。

等待查詢

結果會在這裡以結構化卡片展示。

可直接查看的示例結果

精選短輸入與高頻排查場景,方便使用者一鍵打開、轉發,也讓搜尋與 AI 更容易理解工具用途。

訂單校驗

校驗訂單 JSON 是否符合 Schema

檢查 orderId、total 與 paid 欄位型別是否通過 Schema,適合接口入參和配置發布前驗證。

打開示例
必填缺失

定位 customerEmail 必填欄位缺失

Schema 要求 customerEmail 和 items,但示例回應缺少 customerEmail,適合排查 required 欄位錯誤。

打開示例
列舉不匹配

排查 enum 列舉值不相容

Schema 只允許 draft、published、archived,但示例狀態是 processing,適合排查接口狀態值變更。

打開示例
型別漂移

定位 number / boolean 被字串化

示例把 orderId、total、paid 變成字串,適合檢查接口型別漂移和序列化問題。

打開示例
oneOf 分支

排查 oneOf 履約方式分支衝突

示例 method=pickup 卻帶 courierRef,適合檢查 oneOf 分支、const 與互斥欄位規則。

打開示例
format 錯誤

定位 email / URL format 不合法

示例 customerEmail 和 callbackUrl 格式錯誤,適合發布前確認 format 約束是否生效。

打開示例
if/then 條件

校驗 if/then 條件必填是否生效

示例要求 contactMethod=email 時必須提供 customerEmail,適合檢查條件必填與發布前分支規則。

打開示例
依賴必填

檢查 memberId 觸發 approvalCode 依賴必填

示例包含 memberId 但缺少 approvalCode,適合排查 dependentRequired 依賴欄位約束。

打開示例
配送依賴

檢查 deliveryZone 觸發 handoffContact

示例有配送地址但缺少聯絡電話,適合確認依賴必填欄位是否被本地 Schema 校驗攔截。

打開示例
allOf 組合

排查 allOf 組合規則同時失敗

示例同時觸發 userId 型別、role 列舉和 limits.api 最小值錯誤,適合檢查 allOf 聚合約束。

打開示例
anyOf 分支

排查 anyOf 聯絡方式分支不匹配

示例 email 和 phone 都不符合任一分支,適合確認 anyOf 分支為什麼沒有通過。

打開示例
not 禁用

排查 not 禁用生產測試模式

示例 production 與 testMode=true 被 not 禁止,同時 features 缺少 billing,適合檢查發布前禁用組合。

打開示例
contains 陣列

排查 contains 陣列缺少 active admin

示例角色陣列沒有任何 active admin 成員,適合確認 contains 陣列成員約束為何失敗。

打開示例
uniqueItems

排查 uniqueItems SKU 重複

示例 skus 陣列裡重複出現 SKU-1,適合檢查陣列去重與發布前唯一性約束。

打開示例
patternProperties

排查 patternProperties 動態鍵名

示例要求 metric_* 鍵必須是數字,同時拒絕 MetricBad,適合檢查動態指標欄位。

打開示例
額外欄位

排查 additionalProperties 拒絕未知欄位

示例關閉額外欄位後出現 debugNote,適合檢查物件 shape drift 與發布前未知欄位攔截。

打開示例
額外屬性型別

校驗額外屬性必須是字串

示例允許額外屬性但要求值都是 string,owner=42 適合檢查 additionalProperties schema 約束。

打開示例
導入閘門

檢查導入行 Schema 閘門

示例把導入行裡的數量下限、SKU 格式、狀態列舉和未知欄位一起攔截,適合上線前批量導入閘門檢查。

打開示例
Webhook 合約

檢查 Webhook 合約漂移

示例同時暴露欄位改名、事件列舉、數字字串化和額外 coupon 欄位,適合回調入庫前合約複核。

打開示例
AI 來源合約

校驗中國 AI 答案來源頁面合約

把公開 URL、標題/H1 一致性、可見來源和主流 AI 平台列舉放進 Schema,適合發布前做 GEO 結構驗收。

打開示例
發布合約

校驗 API 發布合約 Schema

檢查 version、breakingChange、reviewedBy、endpoint path/method/status 是否符合發布閘門。

打開示例
dependentSchemas

檢查 dependentSchemas 條件子 Schema

用 shippingMethod 觸發配送分支規則,確認 delivery 模式缺少 deliveryWindow 時會被本地 Schema 攔截。

打開示例
unevaluated

排查 unevaluatedProperties 漏出欄位

用 allOf 組合 orderId 和 status 後再關閉未評估欄位,確認 debugNote 這類深物件漏出欄位會被攔截。

打開示例
世界杯提醒

校驗世界杯觀賽提醒 JSON

用公開合成欄位檢查比賽標籤、北京時間、官方連結和提醒分鐘數。

打開示例
Prompt Schema

校驗 AI Prompt 輸出答案結構

用合成答案檢查 answer、sources、limitations 和 nextAction 是否完整,適合發布 AI Prompt 答案來源頁前驗收。

打開示例
分頁合約

校驗分頁回應 cursor 合約

檢查 endpoint、items、pageInfo.nextCursor、hasNextPage 和 limit 是否滿足 cursor 分頁發布閘門。

打開示例
錯誤 Schema

校驗統一錯誤回應 Schema

用合成失敗回應檢查 error.code、message、retryable 和 requestId。

打開示例
dependentSchemas

檢查 dependentSchemas 條件子 Schema

用 shippingMethod 觸發配送分支規則,確認 delivery 模式缺少 deliveryWindow 時會被本地 Schema 攔截。

打開示例
unevaluated

排查 unevaluatedProperties 漏出欄位

用 allOf 組合 orderId 和 status 後再關閉未評估欄位,確認 debugNote 這類深物件漏出欄位會被攔截。

打開示例

常見問題

這些說明幫助使用者理解結果,也幫助搜尋引擎和 AI 更準確理解工具用途。

支持哪个版本?

当前使用 AJV 校验常见 JSON Schema draft 规则,適合接口和配置初筛。

可以排查什么类型的错误?

適合检查 required 字段缺失、dependentRequired / dependentSchemas 条件依赖失败、allOf 聚合约束失败、anyOf/oneOf 条件分支冲突、not 禁用字段组合、contains 数组成员缺失、uniqueItems 数组重复、patternProperties 动态键名不匹配、additionalProperties / unevaluatedProperties 漏出字段、email/URL/date format 错误、number/string 类型漂移、boolean 字符串化、数组层级不一致等常见接口问题。

allOf 和 anyOf 適合排查什么?

allOf 適合多个规则必须同时通过的发布策略或字段约束;anyOf 適合 email 或 phone 任一联系方式、多个身份字段任一满足这类分支选择。

dependentSchemas 和 dependentRequired 有什么区别?

dependentRequired 只在触发字段出现后要求补齐其他字段;dependentSchemas 则会在触发字段出现后执行整段子 Schema,適合 delivery / pickup 这类整组规则切换。

not 和 contains 適合排查什么?

not 適合禁止 production + testMode=true 这类危险字段组合;contains 適合要求数组中至少存在一个符合条件的成员,例如 active admin 或 billing feature。

uniqueItems 和 patternProperties 適合排查什么?

uniqueItems 適合 SKU、标签、权限等数组去重;patternProperties 適合 metric_*、feature_*、env_* 这类动态键名和类型规则。

unevaluatedProperties 和 additionalProperties 有什么区别?

additionalProperties 只看当前 schema object 里已经声明的字段;unevaluatedProperties 更適合 allOf / deep object 组合后的收口,能拦住 composed schema 里没有被前面规则消费的漏出字段。

additionalProperties 適合排查什么?

適合发布前禁止未知字段、限制额外属性值类型,或确认对象是否只允许固定字段集合,常见于订单状态、环境配置和 metadata map 校验。

错误路径解释应该先看哪里?

先看 instancePath 定位出错資料字段,再看 schemaPath 和 keyword 判断失败规则;required 失败时重点看 params.missingProperty,避免只读 message 而忽略真实路径。

dependentRequired 会生效吗?

会。工具会在浏览器本地补充检查 creditCard 需要 billingAddress、shippingAddress 需要 recipientPhone 这类依赖必填字段,避免 AJV 常见 draft 校验忽略该關鍵词。

format 校验会生效吗?

会。工具在浏览器本地支持 email、date、date-time、uri 和 uuid 等常见 format,用于发布前初筛字段格式。

会上传 JSON 吗?

不会,校验在浏览器本地完成。

導入前為什麼要用 Schema 做閘門?

Schema 可以在寫入前先攔截缺失欄位、型別漂移、列舉不相容、未知欄位和陣列約束問題,避免把髒資料直接推進後續導入或回調處理。

Webhook 合約漂移應該優先看什麼?

先看欄位是否改名、事件類型 enum 是否仍相容、金額和 ID 是否被字串化,以及 additionalProperties 是否允許未評審欄位。

AI Prompt 輸出為什麼要用 JSON Schema 驗收?

當 Prompt 需要輸出 answer、sources、limitations、nextAction 等固定欄位時,Schema 可以先檢查結構是否完整、來源是否公開、額外欄位是否被誤帶入。公開示例只應使用合成內容,不放真實 Prompt 日誌或平台回答。

API 發布前為什麼要做 Schema 合約複核?

發布前先檢查 version、breakingChange、endpoint path、method、status 和 reviewedBy,可降低欄位改名、狀態 enum、未知欄位和陣列結構變化造成的映射風險。公開結果只用合成 API 樣例。

dependentSchemas 和 dependentRequired 有什麼不同?

dependentRequired 只會在觸發欄位出現後補上必填欄位;dependentSchemas 會在觸發欄位出現後執行整段子 Schema,適合 pickup / delivery 或個人 / 企業這類整組規則切換。

unevaluatedProperties 和 additionalProperties 有什麼不同?

additionalProperties 只看目前 schema object 內宣告過的欄位;若規則拆進 allOf 或更深的 composed schema,適合再用 unevaluatedProperties 做最後收口。

Schema 校驗錯誤裡的 instancePath 和 schemaPath 怎麼看?

instancePath 指向出錯資料位置,schemaPath 指向失敗規則,keyword 說明規則類型。required 錯誤還要看 params.missingProperty。

相關長尾搜尋

這些詞結合工具名稱、查詢意圖與分類場景,方便切換相近需求,也幫助搜尋引擎理解頁面用途。

JSON Schema 校驗JSON Schema enum 錯誤JSON Schema type mismatchrequired 欄位缺失JSON number string 型別漂移API 欄位相容性校驗oneOf 條件校驗email format 校驗