RestTemplate测试GET接口List返回：TestBuilder与ParameterizedTypeReference适配问题

问题梳理 #

你遇到的核心问题是搞混了测试数据准备和RestTemplate响应反序列化的类型指定这两个步骤：

• TagTestBuilder的作用是帮你创建并保存测试用的Tag列表，这是测试前的环境准备工作。
• 而RestTemplate的exchange方法需要的是**类型引用（ParameterizedTypeReference）**来指定如何把响应体反序列化成Java对象，不是要你把测试数据传进去。

你之前错误地把TestBuilder生成的实际List对象传给了exchange方法，这就导致了类型不匹配的报错——因为exchange根本不接受实际的List作为类型参数。

正确的测试代码写法 #

你需要把测试数据准备和响应类型指定分开，代码应该是这样的：

@Test
public void findAllEvents() {
    // GIVEN: 用TagTestBuilder创建并保存测试数据，准备好测试环境
    List<Tag> expectedTags = TagTestBuilder
            .withFullList()
            .withSaved()
            .buildList();

    // 定义响应的类型引用，告诉RestTemplate要反序列化成List<Tag>
    ParameterizedTypeReference<List<Tag>> responseType = new ParameterizedTypeReference<List<Tag>>() {};

    // WHEN: 调用接口，用类型引用接收响应
    ResponseEntity<List<Tag>> response = restTemplate.exchange(
            TagResourceConstants.PATH,
            HttpMethod.GET,
            null,
            responseType
    );

    // THEN: 断言状态码和返回的列表内容
    assertEquals(HttpStatus.OK.value(), response.getStatusCodeValue());
    // 还可以断言返回的列表和我们准备的测试数据一致（比如大小、每个Tag的属性）
    assertEquals(expectedTags.size(), response.getBody().size());
    // 如果Tag类重写了equals方法，还可以直接断言列表内容相等
    assertEquals(expectedTags, response.getBody());
}

关键解释 #

1. 测试数据准备：TagTestBuilder.withFullList().withSaved().buildList()这一步是把测试用的Tag数据存入你的测试数据库（假设withSaved()方法做了持久化操作），这样接口调用时才能查询到这些数据。
2. 响应类型指定：ParameterizedTypeReference<List<Tag>>是用来告诉RestTemplate，响应体是一个List类型的集合，因为Java的泛型擦除，直接用List.class无法指定泛型参数，所以必须用这个类来传递类型信息。
3. 断言扩展：除了状态码，你还应该断言返回的列表和你准备的测试数据一致，这样才能确保接口返回的是正确的数据，而不仅仅是状态码正确。

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