免费 JSONPath 测试工具 — 在线求值查询表达式

什么是 JSONPath 测试工具？

// The expression you build in this tester maps straight onto the
// RFC 9535 reference library used under the hood.
import { query, paths } from 'jsonpath-rfc9535';

const document = {
  store: {
    book: [
      { title: 'Sayings of the Century', author: 'Nigel Rees', price: 8.95 },
      { title: 'Sword of Honour', author: 'Evelyn Waugh', price: 12.99 },
      { title: 'Moby Dick', author: 'Herman Melville', price: 8.99 },
      { title: 'The Lord of the Rings', author: 'J. R. R. Tolkien', price: 22.99 }
    ]
  }
};

// Values: query(document, path) returns the matched values directly.
const titles = query(document, '$.store.book[*].title');
// → ['Sayings of the Century', 'Sword of Honour', 'Moby Dick', 'The Lord of the Rings']

// Filter: books cheaper than 10.
const cheap = query(document, '$.store.book[?(@.price < 10)].title');
// → ['Sayings of the Century', 'Moby Dick']

// Normalized paths: paths(document, path) returns where each match lives.
const authorPaths = paths(document, '$..author');
// → ["$['store']['book'][0]['author']", "$['store']['book'][1]['author']", ...]

// RFC 9535 functions like length() are used INSIDE filters, not as a segment.
const longTitles = query(document, '$.store.book[?length(@.title) > 15]');
// → the two books whose title is longer than 15 characters

核心功能

实战示例

$.store.book[*].title

["Sayings of the Century", "Sword of Honour", "Moby Dick", "The Lord of the Rings"]

$.store.book[?(@.price < 10)].title

["Sayings of the Century", "Moby Dick"]

$..author

["Nigel Rees", "Evelyn Waugh", "Herman Melville", "J. R. R. Tolkien"]

$.store.book[0:2].title

["Sayings of the Century", "Sword of Honour"]

$.store.book[?length(@.title) > 15]

[{"title": "Sayings of the Century", "author": "Nigel Rees", "price": 8.95}, {"title": "The Lord of the Rings", "author": "J. R. R. Tolkien", "price": 22.99}]

$.store.book[0]['title','author']

["Sayings of the Century", "Nigel Rees"]

如何使用 JSONPath 测试工具

1. 1

   粘贴或上传你的 JSON

   把 JSON 拖入输入框、粘贴进去，或点击「上传」从磁盘加载 .json / .txt 文件。「格式化 JSON」会重新缩进文档。非法 JSON 会在查询前以解析器消息内联标出。

2. 2

   选择一个引擎

   RFC 9535（2024 年 IETF 标准，无 eval）为默认。当你运行从 jsonpath.com 等旧工具复制来的表达式时，切换到经典 (Goessner)，结果就会与你在那里看到的一致。

3. 3

   输入你的 JSONPath 表达式

   开头的 $ 已为你显示。可以从子路径如 .store.book[*].title、索引如 [0]、递归下降如 ..author，或过滤器如 [?(@.price < 10)] 开始。结果会随你输入实时更新。

4. 4

   切换结果视图

   Values 显示匹配值的 JSON 数组。Paths 显示每条匹配的规范化路径，如 $['store']['book'][0]['title']。Both 把两者并排显示，让你把每个值映射到它在文档中的精确位置。

5. 5

   复制结果或分享永久链接

   「复制结果」会把输出放到你的剪贴板。「复制链接」把 JSON、表达式、引擎和视图编码进 URL hash（无上传），让同事能在自己的机器上本地重现完全一样的查询。

常见 JSONPath 错误

store.book[*].title  →  invalid (no root)

$.store.book[*].title  →  selects every title

$.store.book[0:2]  →  first TWO books, not three

$.store.book[0:3]  →  first three books (indices 0,1,2)

Classic filter run under RFC 9535  →  parse error or unexpected nodes

Switch engine to Classic (Goessner)  →  reproduces the original result

$.store.book.length()  →  parse error (not a valid RFC 9535 segment)

$.store.book[?length(@.title) > 15]  →  books with a title over 15 chars

$.store.book[?($.price < 10)]  →  wrong scope

$.store.book[?(@.price < 10)]  →  books under 10

$[store][book]  →  invalid bracket selectors

$['store']['book']  →  same as $.store.book

$..price  →  every price anywhere in the tree

$.store.book[*].price  →  only book prices

谁会使用本工具

从 API 响应中提取字段

无需编写遍历代码即可从 JSON 负载中提取请求 ID、嵌套资源属性，或一组名称。在这里针对示例响应构建路径，在 Values 视图中确认它精确返回了你想要的节点，然后把验证过的表达式粘贴进你的应用或测试。

为集成测试编写断言

许多测试框架和契约测试工具（REST Assured、Karate、Postman）使用 JSONPath 对响应体做断言。在这里起草断言路径，针对真实响应验证它选中了正确的节点，再复制进你的测试 —— 在测试套件变红之前就抓住错误路径。

在流水线中配置数据转换

Kubernetes、AWS Step Functions、Azure Logic Apps 及许多 ETL 工具接受 JSONPath 来定位事件负载中的字段。在这里针对一个有代表性的事件原型化确切路径，确认它能解析，再放心地放进你的流水线配置，确信它指向你预期的位置。

私密地重现 jsonpath.com 的结果

手头有来自依赖服务器的求值器的表达式，却不能把数据粘贴到第三方网站？切换到经典 (Goessner) 模式，加载你的 JSON，在本地重现相同结果 —— 负载绝不离开你的浏览器，专有数据始终留在你的机器上。

把旧表达式迁移到 RFC 9535

正在迁移到一个声称兼容 RFC 9535 的系统？在经典模式下运行一条旧表达式，然后切到 RFC 9535 引擎，看它是否仍能解析并匹配相同节点。双引擎对比能精确定位你原本会在生产中遇到的过滤器、并集和函数差异。

调试路径为何返回了错误的节点

一条选中过多或过少的路径，仅凭值很难推理。切换到 Paths 视图，查看每条匹配的规范化位置 —— 确切的数组索引、确切的成员链 —— 那个差一切片或多余的递归下降会立刻变得显而易见。

教学或评审 JSONPath

针对示例数据打开一条可用表达式，逐个选择器走读，在 Values 与 Paths 之间切换，让学习者既看到选中了什么、也看到它在哪里。速查表和已演练的示例为代码评审或新人入职提供了结构化参考。

引擎与算法说明

RFC 9535 引擎（jsonpath-rfc9535，零依赖）

默认引擎直接实现 IETF RFC 9535 语法：它把表达式词法分析并解析为抽象语法树，再针对文档解释执行。整条路径中没有任何 eval、没有 Function 构造器，因此它对 eval 注入类漏洞免疫，并可在严格的内容安全策略下运行。

经典引擎（jsonpath-plus，已禁用 eval）

经典 (Goessner) 引擎是 jsonpath-plus，锁定在一个修补版本（>= 10.4.0），且构建时将 eval 选项显式设为 false。这在保持 Goessner 方言兼容的同时，关闭了被记录为 CVE-2024-21534 和 CVE-2025-1302 的远程代码执行向量 —— 它们影响了该库默认的基于 eval 的过滤路径。

规范化路径生成

每条匹配都以其 RFC 9535 规范化路径上报 —— 一种使用单引号方括号表示法（$['store']['book'][0]['title']）、数组索引为裸整数的规范形式。规范化路径稳定且每个节点唯一，所以等价表达式会产生相同路径，而 Paths 与 Both 视图正依赖这一点来无歧义地标识结果。

按需加载的引擎分块

两个引擎都作为独立的 JavaScript 分块，仅在首次选中时加载，因此初始页面保持轻量，你不使用的引擎从不被下载。切换引擎会立即针对当前文档重新求值当前表达式，无需重新加载页面。

本地文件读取与 JSON 格式化

「上传」按钮使用浏览器 FileReader API 完全在客户端把 .json 或 .txt 文件读入输入框 —— 文件绝不会被传输。「格式化 JSON」用两空格缩进解析并重新序列化输入，把解析错误内联呈现，让格式错误的 JSON 在求值前被抓住。

通过 URL hash 的永久链接（绝不传输）

分享状态被编码进 location.hash 片段，携带 JSON、表达式、当前引擎和结果视图。浏览器绝不会在 HTTP 请求中包含该片段，所以打开永久链接时 go-tools.org 服务器收到零数据；填充完全发生在接收方的设备上。

JSONPath 最佳实践

选择与你目标匹配的引擎

如果你的下游系统声称兼容 RFC 9535，就针对 RFC 9535 引擎编写并验证。如果你在重现或维护来自旧工具或旧库的表达式，请使用经典 (Goessner)。对照错误的方言验证，是表达式在测试工具中能用、却在生产中失败的最常见原因。

用 Paths 视图验证，而不只是看 Values

Values 视图告诉你匹配了什么；Paths 视图告诉你在哪里。当一个查询返回看起来正确的值时，它仍可能是从错误的位置选中它们的 —— 一个多余的递归下降或一个过宽的通配符。检查规范化路径，确认表达式精确命中了你预期的节点。

留意切片不包含的结束边界

[0:2] 选取索引 0 和 1，而非 0 到 2 —— 结束边界不包含在内，正如 Python 和 JavaScript。差一切片错误是最常见的 JSONPath bug。用 Paths 视图读取每个被选元素的确切索引，在交付前确认边界。

能用显式路径时就别用递归下降

$..price 很方便，但会匹配文档中任何位置的每个 price，包括你并不想要的。当你了解结构时，写出完整路径（$.store.book[*].price），让查询在数据增长时保持精确可预测。把 .. 留给真正不规则或未知的结构。

在过滤器中保持空白与引号一致

RFC 9535 对过滤表达式严格遵循其语法，而经典方言较为宽松。把过滤器写干净 —— 字符串字面量用单引号（'fiction'）、运算符两侧留空格、不要依赖宽松解析 —— 这样无论最终由哪个引擎或库运行，同一表达式都能求值一致。

常见问题