no suitable HttpMessageConverter found for response type [XXX]

目录

1、背景

2、报错详情

3、代码定位

4、问题解决

---

1、背景

使用Spring的RestTemplate进行网络请求，RestTemplate把数据从 HttpResponse 转换成Object的时候找不到合适的HttpMessageConverter

2、报错详情

Could not extract response: no suitable HttpMessageConverter found for response type [XXX] and content type [text/html;charset=UTF-8]

3、代码定位

从org.springframework.web.client.RestTemplate#execute()开始往下走

定位到org.springframework.web.client.RestTemplate.ResponseEntityResponseExtractor#extractData()

public ResponseEntity extractData(ClientHttpResponse response) throws IOException {
	if (this.delegate != null) {
        //核心：转换响应数据（HttpResponse 转换成Object）
		T body = this.delegate.extractData(response);
		return ResponseEntity.status(response.getRawStatusCode()).headers(response.getHeaders()).body(body);
	}
	else {
		return ResponseEntity.status(response.getRawStatusCode()).headers(response.getHeaders()).build();
	}
}

可以看到，收到response的Header里面的Content-Type值为text/html;charset=UTF-8

继续往下走，通用的http消息转换器匹配到自己的子类MappingJackson2HttpMessageConverter，但是可以看到的是supportedMediaTypes 只支持：application/json 的 MediaType。并不能转换text/html

未匹配到转换器，走到方法最后，就会抛出异常 

throw new UnknownContentTypeException(this.responseType, contentType,
		response.getRawStatusCode(), response.getStatusText(), response.getHeaders(),
		getResponseBody(response));

4、问题解决

需要一个转换器能处理头部 Content-Type 为 text/html 类型的 Json 返回值的话，就能把 Json 反序列化成我们要的对象。

所以需要自定义一个转换器，参照MappingJackson2HttpMessageConverter，继承AbstractJackson2HttpMessageConverter

public class XmMappingJackson2HttpMessageConverter extends AbstractJackson2HttpMessageConverter {
    public XmMappingJackson2HttpMessageConverter(ObjectMapper objectMapper) {
        super(objectMapper, MediaType.TEXT_HTML);
    }
}

可以看到，转换器列表增加了我们的XmMappingJackson2HttpMessageConverter

踩坑：别直接继承MappingJackson2HttpMessageConverter，然后去setSupportedMediaTypes，这样会把人本身覆盖掉