
本文详解使用 JsonPath 在多层嵌套结构(如对象→数组→对象→数组)中精准筛选字段的方法,重点纠正 in 运算符的常见误用,并提供可直接运行的 Java 示例与关键注意事项。
本文详解使用 jsonpath 在多层嵌套结构(如对象→数组→对象→数组)中精准筛选字段的方法,重点纠正 `in` 运算符的常见误用,并提供可直接运行的 java 示例与关键注意事项。
在 Java 开发中,借助 JsonPath 解析复杂 JSON 并提取特定条件的数据是高频需求。但当目标字段位于「对象 → 数组 → 对象 → 字符串数组」这类深层嵌套路径中(例如从 none2b_references__cr 数组中找出 source__c 包含 "nci__c" 的项,并取其 case_identifier__c 值),初学者常因语法理解偏差导致表达式返回空结果。
核心误区在于 in 过滤器的语义:in 要求左侧为单值,右侧为数组。而错误写法 $..[?(@.source__c in ['nci__c'])] 将数组 @.source__c 放在了左侧,违反了 JsonPath 规范,因此匹配失败。
✅ 正确的 JsonPath 表达式应为:
$..case_version__v.case_number__vr.none2b_references__cr[?('nci__c' in @.source__c)].case_identifier__c该表达式明确将字面量 'nci__c' 作为左操作数,@.source__c(即当前对象的 source__c 字段,其值为 ["nci__c"])作为右操作数,从而正确触发“成员存在性”判断。
立即学习“Java免费学习笔记(深入)”;
以下是完整、可运行的 Java 示例(需引入 com.jayway.jsonpath:json-path:2.9.0):
import com.jayway.jsonpath.Configuration;
import com.jayway.jsonpath.DocumentContext;
import com.jayway.jsonpath.JsonPath;
import com.jayway.jsonpath.Option;
import java.util.List;
public class JsonPathFilterExample {
public static void main(String[] args) {
String json = """
{
"case_version__v": {
"case_number__vr": {
"id": "V2A000000001002",
"none2b_references__cr": [
{
"case_number__c": "V2A000000001002",
"case_identifier__c": "THIS-IS-MINE",
"id": "V8C000000001001",
"source__c": ["nci__c"]
}
]
}
}
}
""";
// 启用 ALWAYS_RETURN_LIST 避免单结果返回 String 而非 List,便于统一处理
Configuration config = Configuration.defaultConfiguration()
.addOptions(Option.ALWAYS_RETURN_LIST);
DocumentContext ctx = JsonPath.parse(json, config);
JsonPath path = JsonPath.compile(
"$..case_version__v.case_number__vr.none2b_references__cr[?('nci__c' in @.source__c)].case_identifier__c"
);
List<String> results = ctx.read(path, List.class);
System.out.println(results); // 输出: [THIS-IS-MINE]
}
}⚠️ 注意事项:
- 若 source__c 可能为 null 或非数组类型,建议添加安全检查,例如改用 @.source__c && 'nci__c' in @.source__c;
- JsonPath 的 in 不支持通配符或正则,仅用于精确成员匹配;如需模糊匹配(如前缀、包含子串),需配合 filter() 自定义函数或在 Java 层后处理;
- 使用 ALWAYS_RETURN_LIST 选项可避免单元素时返回 String 导致 ClassCastException,提升健壮性;
- 多层 ..(Deep Scan)虽方便,但在大型 JSON 中可能影响性能,生产环境建议尽可能使用确定路径(如 $['case_version__v']['case_number__vr']['none2b_references__cr'])。
掌握 in 运算符的方向性语义,结合路径精度与配置优化,即可高效、可靠地从任意深度嵌套 JSON 中提取符合业务逻辑的结构化数据。


















