【resttemplate】RestTemplate返回值乱码问题分析与解决_resttemplate 乱码-程序员宅基地

技术标签： spring boot spring cloud ribbon springboot httpclient resttemplate

使用RestTemplate发送请求时，如果接口返回值中包含中文就会出现乱码：

RestTemplate restTemplate = new RestTemplate();
String result = restTemplate.getForObject("http://www.baidu.com", String.class);
System.out.println(result);

运行结果如下：

<!DOCTYPE html>
<!--STATUS OK--><html> <head><meta http-equiv=content-type content=text/html;charset=utf-8><meta http-equiv=X-UA-Compatible content=IE=Edge><meta content=always name=referrer><link rel=stylesheet type=text/css href=http://s1.bdstatic.com/r/www/cache/bdorz/baidu.min.css><title>ç¾åº¦ä¸€ä¸‹ï¼Œä½ å°±çŸ¥é“</title></head> <body link=#0000cc> <div id=wrapper> <div id=head> <div class=head_wrapper> <div class=s_form> <div class=s_form_wrapper> <div id=lg> <img hidefocus=true src=//www.baidu.com/img/bd_logo1.png width=270 height=129> </div> <form id=form name=f action=//www.baidu.com/s class=fm> <input type=hidden name=bdorz_come value=1> <input type=hidden name=ie value=utf-8> <input type=hidden name=f value=8> <input type=hidden name=rsv_bp value=1> <input type=hidden name=rsv_idx value=1> <input type=hidden name=tn value=baidu><span class="bg s_ipt_wr"><input id=kw name=wd class=s_ipt value maxlength=255 autocomplete=off autofocus></span><span class="bg s_btn_wr"><input type=submit id=su value=ç¾åº¦ä¸€ä¸‹ class="bg s_btn"></span> </form> </div> </div> <div id=u1> <a href=http://news.baidu.com name=tj_trnews class=mnav>æ–°é—»</a> <a href=http://www.hao123.com name=tj_trhao123 class=mnav>hao123</a> <a href=http://map.baidu.com name=tj_trmap class=mnav>åœ°å›¾</a> <a href=http://v.baidu.com name=tj_trvideo class=mnav>è§†é¢‘</a> <a href=http://tieba.baidu.com name=tj_trtieba class=mnav>è´´å§</a> <noscript> <a href=http://www.baidu.com/bdorz/login.gif?login&amp;tpl=mn&amp;u=http%3A%2F%2Fwww.baidu.com%2f%3fbdorz_come%3d1 name=tj_login class=lb>ç»å½•</a> </noscript> <script>document.write('<a href="http://www.baidu.com/bdorz/login.gif?login&tpl=mn&u='+ encodeURIComponent(window.location.href+ (window.location.search === "" ? "?" : "&")+ "bdorz_come=1")+ '" name="tj_login" class="lb">ç»å½•</a>');</script> <a href=//www.baidu.com/more/ name=tj_briicon class=bri style="display: block;">æ›´å¤šäº§å“</a> </div> </div> </div> <div id=ftCon> <div id=ftConw> <p id=lh> <a href=http://home.baidu.com>å
³äºŽç¾åº¦</a> <a href=http://ir.baidu.com>About Baidu</a> </p> <p id=cp>&copy;2017&nbsp;Baidu&nbsp;<a href=http://www.baidu.com/duty/>ä½¿ç”¨ç¾åº¦å‰å¿
è¯»</a>&nbsp; <a href=http://jianyi.baidu.com/ class=cp-feedback>æ„è§åé¦ˆ</a>&nbsp;äº¬ICPè¯030173å·&nbsp; <img src=//www.baidu.com/img/gs.gif> </p> </div> </div> </div> </body> </html>

从源码分析原因

这个问题我首先想到的是RestTemplate的MessageConverter消息转换器，首先找到RestTemplate解析response的地方。

org.springframework.web.client.HttpMessageConverterExtractor#extractData

public T extractData(ClientHttpResponse response) throws IOException {
    
    MessageBodyClientHttpResponseWrapper responseWrapper = new MessageBodyClientHttpResponseWrapper(response);
    if (!responseWrapper.hasMessageBody() || responseWrapper.hasEmptyMessageBody()) {
    
        return null;
    }
    MediaType contentType = getContentType(responseWrapper);

    try {
    
        for (HttpMessageConverter<?> messageConverter : this.messageConverters) {
    
            if (messageConverter instanceof GenericHttpMessageConverter) {
    
                GenericHttpMessageConverter<?> genericMessageConverter =
                        (GenericHttpMessageConverter<?>) messageConverter;
                if (genericMessageConverter.canRead(this.responseType, null, contentType)) {
    
                    if (logger.isDebugEnabled()) {
    
                        ResolvableType resolvableType = ResolvableType.forType(this.responseType);
                        logger.debug("Reading to [" + resolvableType + "]");
                    }
                    return (T) genericMessageConverter.read(this.responseType, null, responseWrapper);
                }
            }
            if (this.responseClass != null) {
    
                if (messageConverter.canRead(this.responseClass, contentType)) {
    
                    if (logger.isDebugEnabled()) {
    
                        String className = this.responseClass.getName();
                        logger.debug("Reading to [" + className + "] as \"" + contentType + "\"");
                    }
                    return (T) messageConverter.read((Class) this.responseClass, responseWrapper);
                }
            }
        }
    }
    catch (IOException | HttpMessageNotReadableException ex) {
    
        throw new RestClientException("Error while extracting response for type [" +
                this.responseType + "] and content type [" + contentType + "]", ex);
    }

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

HttpMessageConverter消息转换器

RestTemplate的构造方法中默认内置了下面7个消息转换器：

ByteArrayHttpMessageConverter
StringHttpMessageConverter
ResourceHttpMessageConverter
SourceHttpMessageConverter
AllEncompassingFormHttpMessageConverter
Jaxb2RootElementHttpMessageConverter
MappingJackson2HttpMessageConverter

StringHttpMessageConverter

上面的代码最终会调用StringHttpMessageConverter来对结果进行转换。

canRead()主要根据返回结果的类型和mediaType来进行校验是否可以是否此消息转换器进行转换。

org.springframework.http.converter.AbstractHttpMessageConverter#canRead(java.lang.Class<?>, org.springframework.http.MediaType)

public boolean canRead(Class<?> clazz, @Nullable MediaType mediaType) {
    
    return supports(clazz) && canRead(mediaType);
}

public boolean supports(Class<?> clazz) {
    
    return String.class == clazz;
}

protected boolean canRead(@Nullable MediaType mediaType) {
    
    if (mediaType == null) {
    
        return true;
    }
    for (MediaType supportedMediaType : getSupportedMediaTypes()) {
    
        if (supportedMediaType.includes(mediaType)) {
    
            return true;
        }
    }
    return false;
}

StringHttpMessageConverter支持restTemplate.getForObject传入的class为String类型，mediaType支持所有，在构造方法中指定了MediaType.ALL

public StringHttpMessageConverter() {
    
    this(DEFAULT_CHARSET);
}

/**
 * A constructor accepting a default charset to use if the requested content
 * type does not specify one.
 */
public StringHttpMessageConverter(Charset defaultCharset) {
    
    super(defaultCharset, MediaType.TEXT_PLAIN, MediaType.ALL);
}

当前面的校验通过后，会调用readInternal()对结果进行转换：
org.springframework.http.converter.StringHttpMessageConverter#readInternal

protected String readInternal(Class<? extends String> clazz, HttpInputMessage inputMessage) throws IOException {
    
    Charset charset = getContentTypeCharset(inputMessage.getHeaders().getContentType());
    return StreamUtils.copyToString(inputMessage.getBody(), charset);
}

getContentTypeCharset()会判断使用何种编码方法对结果进行编码，这里使用了默认的编码：
org.springframework.http.converter.StringHttpMessageConverter#getContentTypeCharset

private Charset getContentTypeCharset(@Nullable MediaType contentType) {
    
    if (contentType != null && contentType.getCharset() != null) {
    
        return contentType.getCharset();
    }
    else if (contentType != null &&
            (contentType.isCompatibleWith(MediaType.APPLICATION_JSON) ||
                    contentType.isCompatibleWith(APPLICATION_PLUS_JSON))) {
    
        // Matching to AbstractJackson2HttpMessageConverter#DEFAULT_CHARSET
        return StandardCharsets.UTF_8;
    }
    else {
    
        Charset charset = getDefaultCharset();
        Assert.state(charset != null, "No default charset");
        return charset;
    }
}

在StringHttpMessageConverter的构造方法中指定了默认的编码是ISO_8859_1，这就是乱码的根本原因。

public static final Charset DEFAULT_CHARSET = StandardCharsets.ISO_8859_1;

public StringHttpMessageConverter() {
    
    this(DEFAULT_CHARSET);
}

我们只要将ISO_8859_1修改为UTF-8就能解决乱码问题。

修改StringHttpMessageConverter的编码

方式一：简单粗暴，从源码可得知第一个位置的类型是StringHttpMessageConverter，直接取出来将编码修改为UTF-8。

RestTemplate restTemplate = new RestTemplate();
StringHttpMessageConverter stringHttpMessageConverter = (StringHttpMessageConverter) restTemplate.getMessageConverters().get(1);
stringHttpMessageConverter.setDefaultCharset(StandardCharsets.UTF_8);
String result = restTemplate.getForObject("http://www.baidu.com", String.class);
System.out.println(result);

方式二：推荐使用，通过类型来找到StringHttpMessageConverter，将编码修改为UTF-8。

RestTemplate restTemplate = new RestTemplate();
List<HttpMessageConverter<?>> messageConverters = restTemplate.getMessageConverters();
for (HttpMessageConverter<?> messageConverter : messageConverters) {
    
    if(messageConverter instanceof StringHttpMessageConverter) {
    
        ((StringHttpMessageConverter) messageConverter).setDefaultCharset(StandardCharsets.UTF_8);
    }
}
String result = restTemplate.getForObject("http://www.baidu.com", String.class);
System.out.println(result);

方式三：将所有的消息转换器的编码都修改为UTF-8

RestTemplate restTemplate = new RestTemplate();
List<HttpMessageConverter<?>> messageConverters = restTemplate.getMessageConverters();
for (HttpMessageConverter<?> messageConverter : messageConverters) {
    
    if(messageConverter instanceof AbstractHttpMessageConverter) {
    
        ((AbstractHttpMessageConverter) messageConverter).setDefaultCharset(StandardCharsets.UTF_8);
    } else if(messageConverter instanceof FormHttpMessageConverter) {
    
        ((FormHttpMessageConverter) messageConverter).setCharset(StandardCharsets.UTF_8);
        ((FormHttpMessageConverter) messageConverter).setMultipartCharset(StandardCharsets.UTF_8);
    }
}
String result = restTemplate.getForObject("http://www.baidu.com", String.class);
System.out.println(result);

MappingJackson2HttpMessageConverter

最后来学习一下MappingJackson2HttpMessageConverter，只有MappingJackson2HttpMessageConverter是GenericHttpMessageConverter类型，只有Response的header中的Content-type是application/json才会解析：

public MappingJackson2HttpMessageConverter() {
    
    this(Jackson2ObjectMapperBuilder.json().build());
}

public MappingJackson2HttpMessageConverter(ObjectMapper objectMapper) {
    
    super(objectMapper, MediaType.APPLICATION_JSON, new MediaType("application", "*+json"));
}

MappingJackson2HttpMessageConverter使用了ObjectMapper来进行序列化和反序列化。

本文链接：https://blog.csdn.net/u022812849/article/details/132337202

原作者删帖不实内容删帖广告或垃圾文章投诉

智能推荐

c# 调用c++ lib静态库_c#调用lib-程序员宅基地

文章浏览阅读2w次，点赞7次，收藏51次。四个步骤1.创建C++ Win32项目动态库dll 2.在Win32项目动态库中添加外部依赖项 lib头文件和lib库3.导出C接口4.c#调用c++动态库开始你的表演...①创建一个空白的解决方案，在解决方案中添加 Visual C++ , Win32 项目空白解决方案的创建：添加Visual C++ , Win32 项目这......_c#调用lib

deepin/ubuntu安装苹方字体-程序员宅基地

文章浏览阅读4.6k次。苹方字体是苹果系统上的黑体，挺好看的。注重颜值的网站都会使用，例如知乎：font-family: -apple-system, BlinkMacSystemFont, Helvetica Neue, PingFang SC, Microsoft YaHei, Source Han Sans SC, Noto Sans CJK SC, W..._ubuntu pingfang

html表单常见操作汇总_html表单的处理程序有那些-程序员宅基地

文章浏览阅读159次。表单表单概述表单标签表单域按钮控件demo表单标签表单标签基本语法结构<form action="处理数据程序的url地址“ method=”get|post“ name="表单名称”></form><!--method将表单中的数据传送给服务器处理，get方式直接显示在url地址中，数据可以被缓存，且长度有限制；而post方式数据隐藏传输，_html表单的处理程序有那些

PHP设置谷歌验证器（Google Authenticator）实现操作二步验证_php otp 验证器-程序员宅基地

文章浏览阅读1.2k次。使用说明:开启Google的登陆二步验证（即Google Authenticator服务）后用户登陆时需要输入额外由手机客户端生成的一次性密码。实现Google Authenticator功能需要服务器端和客户端的支持。服务器端负责密钥的生成、验证一次性密码是否正确。客户端记录密钥后生成一次性密码。下载谷歌验证类库文件放到项目合适位置(我这边放在项目Vender下面)https://github.com/PHPGangsta/GoogleAuthenticatorPHP代码示例://引入谷_php otp 验证器

【Python】matplotlib.plot画图横坐标混乱及间隔处理_matplotlib更改横轴间距-程序员宅基地

文章浏览阅读4.3k次，点赞5次，收藏11次。matplotlib.plot画图横坐标混乱及间隔处理_matplotlib更改横轴间距

docker — 容器存储_docker 保存容器-程序员宅基地

文章浏览阅读2.2k次。①Storage driver 处理各镜像层及容器层的处理细节，实现了多层数据的堆叠，为用户提供了多层数据合并后的统一视图②所有 Storage driver 都使用可堆叠图像层和写时复制（CoW）策略③docker info 命令可查看当系统上的 storage driver主要用于测试目的，不建议用于生成环境。_docker 保存容器

随便推点

网络拓扑结构_网络拓扑csdn-程序员宅基地

文章浏览阅读834次，点赞27次，收藏13次。网络拓扑结构是指计算机网络中各组件（如计算机、服务器、打印机、路由器、交换机等设备）及其连接线路在物理布局或逻辑构型上的排列形式。这种布局不仅描述了设备间的实际物理连接方式，也决定了数据在网络中流动的路径和方式。不同的网络拓扑结构影响着网络的性能、可靠性、可扩展性及管理维护的难易程度。_网络拓扑csdn

JS重写Date函数，兼容IOS系统_date.prototype 将所有 ios-程序员宅基地

文章浏览阅读1.8k次，点赞5次，收藏8次。IOS系统Date的坑要创建一个指定时间的new Date对象时，通常的做法是：new Date("2020-09-21 11:11:00")这行代码在 PC 端和安卓端都是正常的，而在 iOS 端则会提示 Invalid Date 无效日期。在IOS年月日中间的横岗许换成斜杠，也就是new Date("2020/09/21 11:11:00")通常为了兼容IOS的这个坑，需要做一些额外的特殊处理，笔者在开发的时候经常会忘了兼容IOS系统。所以就想试着重写Date函数，一劳永逸，避免每次ne_date.prototype 将所有 ios