Spring Boot中RestTemplate POST响应无法正确映射自定义对象问题

1. 字段名称映射不匹配 #

接口返回的JSON字段名与AssistenzaResponse类中results字段的命名规则不匹配，比如接口返回下划线命名（result_items）而类中用驼峰命名（results），Jackson默认的命名策略无法自动匹配，导致字段无法赋值。

解决：在类的results字段上添加@JsonProperty注解指定JSON中的对应字段名，示例：

@JsonProperty("results") // 替换为接口实际返回的字段名
private List<ResultItem> results;

或者直接调整类字段名与JSON返回完全一致。

2. 缺少Getter/Setter方法 #

AssistenzaResponse类的results字段没有公开的getter和setter方法，Jackson反序列化时无法通过反射为字段赋值，最终导致字段为空。

解决：手动添加标准的getter/setter方法，或者使用Lombok的@Data、@Getter、@Setter注解自动生成。

3. 嵌套对象反序列化异常 #

如果results是嵌套对象集合（如List<ResultDetail>），对应的嵌套类（ResultDetail）可能存在字段映射错误、缺少访问方法等问题，导致整个集合无法被正确解析，表现为results为空。

解决：检查嵌套类的字段配置，确保每个嵌套类都有正确的字段映射和公开的getter/setter方法。

4. 泛型类型擦除问题 #

使用postForObject或postForEntity直接传入AssistenzaResponse.class时，若results是泛型集合，Java的类型擦除会导致Jackson无法识别集合的具体元素类型，进而无法正确反序列化。

解决：改用exchange方法配合ParameterizedTypeReference指定泛型类型，示例：

HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_JSON);
HttpEntity<YourRequest> requestEntity = new HttpEntity<>(yourRequestObj, headers);

ResponseEntity<AssistenzaResponse> response = restTemplate.exchange(
    "your-api-url",
    HttpMethod.POST,
    requestEntity,
    new ParameterizedTypeReference<AssistenzaResponse>() {}
);
AssistenzaResponse responseBody = response.getBody();

5. RestTemplate的JSON转换器配置错误 #

RestTemplate默认的MappingJackson2HttpMessageConverter可能被修改了配置，比如错误的命名策略、开启了严格的未知字段校验等，导致反序列化时无法正确处理results字段。

解决：重新配置RestTemplate的Jackson转换器，确保适配接口返回的JSON格式，示例：

@Bean
public RestTemplate restTemplate() {
    RestTemplate restTemplate = new RestTemplate();
    MappingJackson2HttpMessageConverter jacksonConverter = new MappingJackson2HttpMessageConverter();
    ObjectMapper objectMapper = new ObjectMapper();
    // 根据接口返回的命名规则调整，比如下划线转驼峰
    objectMapper.setPropertyNamingStrategy(PropertyNamingStrategy.SNAKE_CASE);
    // 允许忽略未知字段，避免因接口额外字段导致反序列化失败
    objectMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
    jacksonConverter.setObjectMapper(objectMapper);
    // 将自定义转换器放到最前面，优先使用
    restTemplate.getMessageConverters().add(0, jacksonConverter);
    return restTemplate;
}

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