QUERY · FILTER · NAVIGATE

在线 JSONPath 查询工具：筛选与定位 JSON 数据

不用反复折叠长文件，通过路径表达式直接找到深层字段、数组成员和满足条件的数据。

打开 JSONUtils 查看全部指南

01

什么时候使用

从接口响应中提取嵌套字段或数组元素
验证自动化测试、采集规则和数据映射中的 JSONPath
配合树形结构确认字段层级和实际数据类型

02

操作步骤

先校验源 JSON，确保查询输入能够正常解析。
打开 JSONPath 面板并输入表达式，观察匹配数量和结果。
从简单路径逐步增加通配符、数组下标或过滤条件。

03

结果检查

先确认使用方支持的 JSONPath 方言，复杂语法可能存在差异。
空结果不一定是错误，也可能是路径、大小写或类型不匹配。
查询只用于定位和读取；修改数据前仍要确认目标范围。

04

输入与预期结果

用数组通配符可以一次提取所有用户名称，先从简单路径验证层级，再增加过滤条件。

输入 JSON 与查询表达式 $.users[*].name

{
  "users": [
    {"name": "Ada", "active": true},
    {"name": "Lin", "active": false}
  ]
}

预期匹配结果

[
  "Ada",
  "Lin"
]

05

常见问题排查

先确认输入、所选工具和预期结果，再按下面的任务边界逐项排查。

表达式没有结果: 先确认键名大小写和数组层级，再用 $.users 验证上一级路径是否存在。
过滤表达式在别处可用、这里不可用: 不同实现支持的 JSONPath 方言不同，优先使用基础路径、通配符和明确的数组下标。
结果类型与预期不同: 单个匹配和多个匹配可能返回不同形态，接入脚本前先固定调用方需要的结果结构。