RestTemplate中ObjectMapper解析问题（附类结构代码）

我太懂这种泛型反序列化踩坑的感觉了！核心问题是Java的类型擦除机制——运行时ObjectMapper没法知道Payload<T>里的T具体是什么类型，直接用Response.class或者Payload.class解析的话，data列表里的元素会被默认转成LinkedHashMap，而不是你期望的泛型类实例。

下面给你两个实用的解决方案：

方案一：用ParameterizedTypeReference保留泛型类型信息 #

这是最直接的办法，通过匿名内部类的方式让JVM保留完整的泛型类型元数据，让ObjectMapper能精准解析。

举个实际代码例子，假设你的泛型T是User类：

RestTemplate restTemplate = new RestTemplate();

// 定义带具体泛型的类型引用
ParameterizedTypeReference<Response<User>> typeReference = new ParameterizedTypeReference<>() {};

// 调用exchange方法时传入这个类型引用
ResponseEntity<Response<User>> responseEntity = restTemplate.exchange(
    "https://your-api-endpoint.com/data",
    HttpMethod.GET,
    null,
    typeReference
);

// 现在就能正确拿到泛型类型的列表了
Response<User> response = responseEntity.getBody();
List<User> userList = response.getPayload().getData();

原理很简单：ParameterizedTypeReference的匿名子类会在编译时保留泛型参数的具体类型，RestTemplate里的Jackson转换器就能通过这个类型信息正确反序列化data里的每一个元素。

方案二：配置RestTemplate的Jackson转换器增强泛型支持 #

如果你的项目里有很多地方需要处理泛型返回，可以全局配置RestTemplate的MappingJackson2HttpMessageConverter，让ObjectMapper更好地处理泛型场景：

@Bean
public RestTemplate customRestTemplate() {
    RestTemplate restTemplate = new RestTemplate();
    
    // 创建自定义的Jackson消息转换器
    MappingJackson2HttpMessageConverter jacksonConverter = new MappingJackson2HttpMessageConverter();
    ObjectMapper objectMapper = new ObjectMapper()
            // 可选：忽略JSON里未知的字段，避免解析报错
            .configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false)
            // 可选：支持Java 8的日期时间类型
            .registerModule(new JavaTimeModule());
    
    jacksonConverter.setObjectMapper(objectMapper);
    
    // 替换RestTemplate默认的Jackson转换器
    restTemplate.getMessageConverters().removeIf(converter -> converter instanceof MappingJackson2HttpMessageConverter);
    restTemplate.getMessageConverters().add(jacksonConverter);
    
    return restTemplate;
}

注意：这个配置只是增强了Jackson的能力，实际调用时还是需要结合ParameterizedTypeReference来指定具体的泛型类型，毕竟ObjectMapper还是需要知道T到底是什么。

几个额外的注意点 #

• 确保你的泛型类（比如User）有无参构造函数，如果用了全参构造函数，要加上@JsonCreator注解并给参数标记@JsonProperty，否则Jackson没法实例化对象。
• 检查@JsonProperty的字段名是否和接口返回的JSON完全一致（大小写敏感！），比如接口返回的是"data"，你的注解就不能写成"Data"。
• 如果接口返回的data可能为null，记得在代码里做非空判断，避免NullPointerException。

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