FastJson JSONPath 路径取值用法与场景总结

FastJson JSONPath 路径取值用法与场景总结

前言

在日常后端开发中，我们经常需要解析第三方接口返回的 JSON 数据。
传统方式需要一层层getJSONObject()、getString()，代码繁琐、可读性差、维护成本高。
FastJson 提供的JSONPath可以通过路径表达式直接取值，一行代码搞定复杂嵌套 JSON，极大简化开发。

一、JSONPath 常用使用场景

场景1：解析多层嵌套的第三方接口返回值（最常用）

第三方接口返回的 JSON 往往嵌套很深，例如：

{"code":200,"data":{"result":{"userInfo":{"nickName":"张三","phone":"13800138000"}}}}

传统取值需要写：

json.getJSONObject("data").getJSONObject("result").getJSONObject("userInfo").getString("nickName");

层级越多越麻烦，还容易空指针。
使用 JSONPath 只需要一行，直接按路径取。

场景2：接口配置化、动态解析（数据库配置路径）

当系统需要对接大量第三方接口时：

• 请求地址、请求头、请求体存在数据库
• 响应的解析路径也存在数据库

程序不需要为每个接口写硬编码解析逻辑，只需要读取配置的 JSONPath 路径，动态取值。
新增接口 = 配一条记录，零代码开发。

场景3：快速提取数组、列表中的字段

JSON 里包含列表时，例如：

{"list":[{"id":1,"name":"A"},{"id":2,"name":"B"}]}

可以直接取：

• list[0].name
• list[*].name

不用遍历、不用循环，一行拿到结果。

场景4：统一封装工具类，避免重复代码

项目中 JSON 解析无处不在，把 JSONPath 封装成工具类，所有模块复用，代码更整洁。

二、依赖配置（你指定的版本）

<dependency><groupId>com.alibaba</groupId><artifactId>fastjson</artifactId><version>1.2.83</version></dependency>

三、最简演示代码（你原版代码，我帮你整理规范）

importcom.alibaba.fastjson.JSONObject;importcom.alibaba.fastjson.JSONPath;publicclassFastJsonPathDemo{publicstaticvoidmain(String[]args){// 1. 定义 JSON 字符串（多层嵌套结构）Stringjson="{\"data\":{\"user\":{\"name\":\"张三\"}}}";// 2. 一行代码根据路径取值Stringname=(String)JSONPath.eval(JSONObject.parseObject(json),"data.user.name");// 3. 输出结果System.out.println("取值结果："+name);}}

运行输出

取值结果：张三

四、更多常用演示（方便你复习）

1. 直接传 JSON 字符串（更简单）

Stringname=(String)JSONPath.eval(json,"data.user.name");

2. 取数字类型

Stringjson="{\"data\":{\"user\":{\"age\":20}}}";Integerage=(Integer)JSONPath.eval(json,"data.user.age");

3. 取数组中某个字段

Stringjson="{\"list\":[{\"name\":\"张三\"},{\"name\":\"李四\"}]}";StringfirstName=(String)JSONPath.eval(json,"list[0].name");

五、总结（极简好记）

1. 多层嵌套 JSON 取值，一行搞定，不用层层 get
2. 接口配置化平台：路径存在数据库，动态解析，零代码扩展
3. 数组、复杂结构都支持
4. 代码简洁、易读、易维护