使用Spring RestTemplate调用接口并解析JSON数值字段至自定义对象问题

我之前也碰到过类似的RestTemplate数值字段反序列化坑，给你几个实用的排查和解决方向：

常见排查与解决方法 #

• 检查字段类型与JSON响应的匹配度
  首先确认你的自定义对象里的数值字段类型，和WS返回的JSON数值类型完全一致：

  • 如果WS返回的是字符串格式的数字（比如"score": "95"），但你用了Integer score，就会触发反序列化错误。这种情况要么把字段改成String score，要么给字段加上Jackson的反序列化注解：

    @JsonDeserialize(using = StringToIntegerDeserializer.class)
    private Integer score;
    

  • 如果返回的数值是超大整数（超过Integer范围），但你用了Integer类型，会导致溢出或者解析失败，建议换成Long类型。

• 自定义RestTemplate的消息转换器
  默认的RestTemplate可能没有适配你的数值解析需求，你可以手动配置Jackson的ObjectMapper来调整反序列化规则：

  // 初始化自定义ObjectMapper
  ObjectMapper objectMapper = new ObjectMapper();
  // 允许空数值字段转为默认值（比如int转0，long转0L）
  objectMapper.configure(DeserializationFeature.FAIL_ON_NULL_FOR_PRIMITIVES, false);
  // 自动将JSON中的整数转为Long，避免Integer溢出
  objectMapper.enable(DeserializationFeature.USE_LONG_FOR_INTS);
  
  // 替换RestTemplate的消息转换器
  MappingJackson2HttpMessageConverter converter = new MappingJackson2HttpMessageConverter();
  converter.setObjectMapper(objectMapper);
  
  RestTemplate restTemplate = new RestTemplate();
  // 把自定义转换器放到最前面，优先使用
  restTemplate.getMessageConverters().add(0, converter);
  

• 确认对象字段与JSON结构的映射关系
  有时候字段名不匹配也会导致数值解析失败，比如JSON里是"user_age"，但你的实体类字段是userAge，这时候需要加上@JsonProperty注解明确映射：

  @JsonProperty("user_age")
  private Integer userAge;
  

  另外如果是嵌套对象里的数值字段，也要确保嵌套类的字段定义正确。

• 捕获具体异常定位问题
  最直接的方式是捕获反序列化相关的异常，查看详细错误信息，能精准定位到哪个字段出问题：

  try {
      HttpEntity<MultiValueMap<String, String>> requestEntity = new HttpEntity<>(map, headers);
      YourCustomResponse response = restTemplate.postForObject(wsURL, requestEntity, YourCustomResponse.class);
  } catch (HttpMessageNotReadableException e) {
      // 打印完整异常栈
      e.printStackTrace();
      // 提取更具体的Jackson错误信息
      Throwable rootCause = e.getRootCause();
      if (rootCause instanceof JsonMappingException) {
          JsonMappingException jsonEx = (JsonMappingException) rootCause;
          System.out.println("解析失败的字段路径: " + jsonEx.getPath());
          System.out.println("具体错误: " + jsonEx.getOriginalMessage());
      }
  }
  

内容的提问来源于stack exchange，提问作者adrian.fernandez