如何使用RestAssured精准提取嵌套JSON中满足条件的字段值

在接口测试场景中，接口返回的JSON数据往往存在多层嵌套结构，比如订单列表接口可能返回包含用户、商品、物流等多层信息的JSON，此时如果需要提取其中满足特定条件的字段，比如价格大于100的商品名称，就需要用到RestAssured的JSON提取能力。

RestAssured的JSON提取基础

RestAssured内置了JsonPath工具，可以直接对接口返回的JSON数据进行路径定位和提取，不需要额外引入其他JSON解析依赖。首先我们需要先获取接口返回的响应对象，再通过jsonPath()方法获取JsonPath实例。

基础的提取逻辑如下，假设我们有一个简单的嵌套JSON返回：

import io.restassured.RestAssured;
import io.restassured.path.json.JsonPath;
import static io.restassured.RestAssured.given;

public class JsonExtractDemo {
    public static void main(String[] args) {
        // 发送GET请求获取响应
        String response = given()
                .when()
                .get("http://ipipp.com/api/test_nested_json")
                .then()
                .extract()
                .response()
                .asString();
        // 将响应字符串转换为JsonPath对象
        JsonPath jsonPath = new JsonPath(response);
        // 提取根节点下的直接字段
        String userName = jsonPath.getString("user.name");
        System.out.println("用户名称：" + userName);
    }
}

嵌套JSON的路径定位规则

对于多层嵌套的JSON，JsonPath使用点号.来分隔不同层级的节点，数组元素则通过方括号加索引的方式定位，索引从0开始。比如下面这个嵌套JSON结构：

{
    "code": 200,
    "data": {
        "user": {
            "id": 1,
            "name": "张三",
            "orders": [
                {
                    "order_id": "1001",
                    "products": [
                        {"product_name": "手机", "price": 2999},
                        {"product_name": "耳机", "price": 199}
                    ]
                },
                {
                    "order_id": "1002",
                    "products": [
                        {"product_name": "平板", "price": 3999},
                        {"product_name": "键盘", "price": 299}
                    ]
                }
            ]
        }
    }
}

如果要提取第一个订单的第一个商品名称，路径就是data.user.orders[0].products[0].product_name，对应的提取代码为：

// 提取第一个订单的第一个商品名称
String firstProductName = jsonPath.getString("data.user.orders[0].products[0].product_name");
System.out.println("第一个商品名称：" + firstProductName);

提取满足条件的字段值

如果我们需要提取所有价格大于300的商品名称，就需要用到JsonPath的条件过滤语法，过滤表达式写在方括号中，使用?开头，后面跟上判断逻辑。

单条件过滤提取

提取所有价格大于300的商品名称，代码如下：

// 提取所有价格大于300的商品名称，返回List集合
List<String> highPriceProducts = jsonPath.getList("data.user.orders.products.findAll{it.price > 300}.product_name");
System.out.println("价格大于300的商品：" + highPriceProducts);

这里的findAll{it.price > 300}表示遍历所有products元素，筛选出price大于300的元素，it代表当前遍历的元素。

多条件组合过滤

如果需要同时满足多个条件，比如提取价格大于300且商品名称包含"机"的商品，可以使用逻辑运算符组合条件：

// 提取价格大于300且名称包含"机"的商品名称
List<String> targetProducts = jsonPath.getList("data.user.orders.products.findAll{it.price > 300 && it.product_name.contains('机')}.product_name");
System.out.println("符合条件的商品：" + targetProducts);

提取单个满足条件的元素

如果只需要提取第一个满足条件的元素，不需要返回集合，可以使用find代替findAll：

// 提取第一个价格大于300的商品名称
String firstTargetProduct = jsonPath.getString("data.user.orders.products.find{it.price > 300}.product_name");
System.out.println("第一个符合条件的商品：" + firstTargetProduct);

常见问题与注意事项

• 路径书写错误会导致提取结果为null，可以先通过jsonPath.prettyPrint()打印整个JSON结构，确认节点名称是否正确。
• 过滤表达式中的字符串判断需要使用单引号，比如it.product_name == '手机'，不能使用双引号，否则会语法报错。
• 如果提取的字段不存在，JsonPath会返回null，建议提取后先做非空判断再使用，避免空指针异常。

注意：如果接口返回的是XML格式数据，RestAssured也提供了对应的XmlPath工具，提取逻辑和JsonPath类似，只是路径语法不同。

RestAssuredJSON_path嵌套JSON字段提取修改时间：2026-06-12 12:09:29