如何将RestAssured响应中的子元素反序列化为POJO列表？

核心问题定位 #

Java版本升级到17后，RestAssured默认的对象映射配置可能发生变化，加上旧依赖类库停止维护，导致原Gson处理逻辑失效，Response.path("pets")返回HashMap而非目标POJO列表。

解决方案 #

方法1：使用RestAssured JsonPath直接指定类型提取 #

RestAssured的JsonPath提供了直接指定泛型类型的提取方法，无需手动处理HashMap：

import io.restassured.path.json.JsonPath;

// 发送请求获取响应
Response response = given().when().get("/your-api-endpoint");

// 直接提取pets数组为List<Pet>
List<Pet> petList = JsonPath.from(response.asString()).getList("pets", Pet.class);

或者更简洁的链式调用：

List<Pet> petList = given()
        .when()
        .get("/your-api-endpoint")
        .jsonPath()
        .getList("pets", Pet.class);

方法2：重新配置RestAssured使用Gson作为默认对象映射器 #

如果RestAssured默认切换到了Jackson或其他映射器，显式配置Gson：

1. 确保依赖中包含Gson和RestAssured的Gson支持（以Maven为例）：

<dependency>
    <groupId>io.rest-assured</groupId>
    <artifactId>rest-assured</artifactId>
    <version>你的RestAssured版本</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>com.google.code.gson</groupId>
    <artifactId>gson</artifactId>
    <version>你的Gson版本</version>
</dependency>

2. 在测试类初始化时配置Gson：

import io.restassured.RestAssured;
import io.restassured.config.ObjectMapperConfig;
import io.restassured.config.RestAssuredConfig;
import com.google.gson.GsonBuilder;

@BeforeAll
public static void setupRestAssured() {
    RestAssured.config = RestAssuredConfig.config()
            .objectMapperConfig(new ObjectMapperConfig()
                    .gsonObjectMapperFactory((type, s) -> new GsonBuilder().create()));
}

配置后，提取子数组时会自动映射为POJO列表，也可直接用response.getBody().as(目标类.class)处理完整响应。

方法3：手动用Gson转换HashMap列表 #

如果上述方法都不生效，手动将HashMap集合序列化为JSON字符串再反序列化为List：

import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;
import java.util.List;
import java.util.Map;

// 获取HashMap列表
List<Map<String, Object>> rawPets = response.path("pets");

// 用Gson转换为List<Pet>
Gson gson = new Gson();
List<Pet> petList = gson.fromJson(
        gson.toJson(rawPets),
        new TypeToken<List<Pet>>() {}.getType()
);

Java17模块化注意事项 #

如果你的项目是模块化（使用module-info.java），需要在模块声明中添加依赖：

module your.module.name {
    requires io.restassured;
    requires com.google.gson;
    // 如果Pet类在当前模块，需要导出对应包：
    exports com.your.package.where.pet.is;
}

内容的提问来源于stack exchange，提问作者PeekPopBear95