DiagramPreview
基礎解析無需 AI本機預覽可匯出除錯友好

JSONPath 測試器

貼上 JSONPath 測試器 內容,在瀏覽器內產生可檢查的本機預覽,適合除錯設定、API 回應、SEO 技術檔與 AI 生成片段。

範例
JSONPath 命中结果就緒
預覽結果會顯示在這裡。

下一步可以繼續

把目前預覽結果帶到相關工具,繼續轉換、排查或匯出。

SQL 转 ER 图

把 CREATE TABLE SQL 转成 Mermaid ER 图。

開啟
JSON Schema 可视化

查看 JSON Schema 属性、类型、必填字段和组合结构。

開啟
JSON Schema 表單預覽

把 JSON Schema 的屬性、必填項、列舉和格式轉成表單預覽。

開啟

使用方法

  1. 1粘贴有代表性的 JSON payload,并把第一行写成 JSONPath 表达式。
  2. 2通过邮箱提取、订单金额、递归 duration 等示例理解输入格式。
  3. 3复制到测试或文档前,先检查匹配数量、首个匹配值和结果表。
  4. 4如果没有匹配,逐段简化表达式,确认从哪一层开始失败。

常見場景

API 响应调试Webhook payload review测试断言设计AI JSON 输出校验嵌套数组检查

常見問題

为什么 JSONPath 没有匹配结果?

常见原因是缺少根选择器、数组层级需要 [*]、字段名拼错,或者真实 payload 结构和写表达式时用的示例不同。

复杂 JSONPath 怎么调试?

先从 $ 或顶层字段开始,每次只增加一个路径段,确认匹配数量后再加过滤器或递归选择器。

这能替代生产 JSONPath 库吗?

不能。它是预览和 review 界面,最终行为仍应使用项目里的 JSONPath 库和测试来确认。

JSONPath Tester 用来检查 API 响应、fixture、webhook payload 和 AI 生成 JSON,不需要临时写脚本。

预览会显示匹配值、结果形态和表格,帮助你确认表达式是否选中了期望字段。

它适合设计测试断言、检查监控 payload、准备文档示例,以及调试嵌套数组里容易选多或选空的路径。

Demo:从嵌套 API 响应提取用户邮箱

实用的 JSONPath review 应该使用接近生产结构、但脱敏后的 payload。预览匹配值和结果表后,再把表达式写进测试断言。

  • 字段可能出现在不同层级时,可以先用 $..email 探索。
  • 结构稳定时,用 $.users[*].email 这类严格路径。
  • 测试里优先用严格路径,探索时才使用递归路径。
$.users[*].email
{
  "users": [
    {"id": 1, "email": "ada@example.com"},
    {"id": 2, "email": "grace@example.com"}
  ]
}

第一行是表达式,后面是要检查的 JSON payload。

Code review 前值得提前发现的 JSONPath 问题

JSONPath 看起来正确,也可能选中了错误层级。预览结果能让这些问题在进入测试或文档前暴露出来。

  • 递归选择器可能匹配到无关对象里的同名字段。
  • [0] 这类数组索引依赖顺序,示例不一定代表生产数据。
  • 过滤器应该同时用命中和不命中的记录测试。

JSONPath 測試器 檢查清單

當你需要在文件、PR、事故復盤或交接材料發布前檢查原始內容時,可以使用 JSONPath 測試器。針對 API 回應執行常見 JSONPath 表達式,並查看匹配值。

匯出前建議檢查標籤是否可讀、關係是否和原始內容一致、範例是否包含敏感資訊,以及修改輸入後預覽是否仍然成立。

限制與排查

如果預覽失敗,先把輸入縮小到最小完整範例,確認格式語法,再逐段加回內容。

請把預覽結果視為 review 介面,而不是正式事實來源。進入文件或維運流程前仍需要人工確認。

可測試的範例輸入

  • 使用者信箱: $.users[*].email --- { "users": [ {"id": 1, "email": "ada@example.com", "role": "admin"}, {"id": 2, "email": "lin@example.com", "role": "viewer"} ] }
  • 首筆訂單總額: $.orders[0].total --- { "orders": [ {"id": "ord_1", "total": 49.9}, {"id": "ord_2", "total": 19.5} ] }
  • 遞迴耗時: $..durationMs --- { "trace": { "durationMs": 340, "spans": [{"name": "api", "durationMs": 120}, {"name": "db", "durationMs": 180}] } }

工具完成度

基礎解析

基礎解析

此工具偏向快速結構檢查,適合預覽、排查與定位問題;關鍵輸出進入正式流程前仍需人工複核。

分級不是品質分數,而是說明目前工具更適合穩定匯出、深度除錯、快速解析,或 AI 輔助生成。