基于restTemplate遇到的编码问题及解决基于restTemplate遇到的编码问题

背景
问题一：中文乱码

描述
分析
结论
方案
总结

问题二：特殊字符串丢失

描述
分析
结论
方案

背景之前用restTemplate做网络间的请求，没遇到过问题。今天先是出现了中文乱码的问题，而后又出现了特殊字符丢失的问题，于是查找资料及翻看源码，将问题解决也顺便记录下。

问题一：中文乱码

描述
在创建课件时，使用GET方法传递类型和标题两个参数到服务器，服务器返回一个课件编号。类型是固定数字1，不存在问题，而标题则是用户输入字符串，也就是任意字符串。发现输入汉字的时候，结果网络传输后在服务器端出现了乱码。输入标题为：开发测试001，结果在服务器上接收到的为：%E5%BC%80%E5%8F%91%E6%B5%8B%E8%AF%95001。

分析
出现编码问题，那肯定是对涉及到这个标题的编码的位置出现了问题，于是查找涉及到的代码位置：

public String createPptSlide(String title) {UriComponentsBuilder builder = UriComponentsBuilder.fromHttpUrl(host + PPT_SLIDE_INSERT); builder.queryParam("businessLineId", PPT_BUSINESS_LINE_ID); builder.queryParam("slideTitle", title); String url = builder.toUriString(); restTemplate.getForEntity(url, JSONObject.class); }

此处的String url已经是编码过了的http://xxx.com/slide/insertEmptySlide?businessLineId=1&slideTitle=%E5%BC%80%E5%8F%91%E6%B5%8B%E8%AF%95001

于是继续追踪getForEntity方法，在执行doExecute方法前，构造URI时又进行了一次编码，如下：

@Overridepublic ResponseEntity getForEntity(String url, Class responseType, Map urlVariables)throws RestClientException {RequestCallback requestCallback = acceptHeaderRequestCallback(responseType); ResponseExtractor> responseExtractor = responseEntityExtractor(responseType); return execute(url, HttpMethod.GET, requestCallback, responseExtractor, urlVariables); }public T execute(String url, HttpMethod method, RequestCallback requestCallback,ResponseExtractor responseExtractor, Map urlVariables) throws RestClientException {URI expanded = new UriTemplate(url).expand(urlVariables); return doExecute(expanded, method, requestCallback, responseExtractor); }public URI expand(Map uriVariables) {UriComponents expandedComponents = this.uriComponents.expand(uriVariables); UriComponents encodedComponents = expandedComponents.encode(); return encodedComponents.toUri(); }

【基于restTemplate遇到的编码问题及解决】

结论
在程序构建url时，程序代码已经对title进行了一次编码，，传入restTemplate后，restTemplate框架本身又会对其做一次编码，最后服务器接收到的参数其实是做了两次编码，导致解码后还是乱码。

第一次编码：%E5%BC%80%E5%8F%91%E6%B5%8B%E8%AF%95001
第二次编码：%25E5%25BC%2580%25E5%258F%2591%25E6%25B5%258B%25E8%25AF%2595001
解码后：%E5%BC%80%E5%8F%91%E6%B5%8B%E8%AF%95001

侧面论证：
这里的编码是URLencode，这个编码简单来讲就是：将非字母数字字符都将被替换成百分号（%）后跟两位十六进制数。可以看到这一串的乱码%E5%BC%80%E5%8F%91%E6%B5%8B%E8%AF%95001很像urlencode后的结果，解码后发现果真是这样。

文章图片

方案
传入url前不对title进行编码，直接拼接原始的参数，然后传入到restTemplate，让restTemplate框架来进行编码。这样解决了中文乱码的问题，如下：

UriComponentsBuilder builder = UriComponentsBuilder.fromHttpUrl(host + PPT_SLIDE_INSERT); builder.queryParam("businessLineId", PPT_BUSINESS_LINE_ID); String url = builder.toUriString(); // 不能 encode 参数if (StringUtils.isNotBlank(title)) {url = url + "&slideTitle=" + title; }restTemplate.getForEntity(url, JSONObject.class); }

总结
项目中使用restTemplate的地方，在传给restTemplate框架url的时候都进行了一次编码，于是自己也照搬过来，殊不知restTemplate框架本身就会对url进行编码。
其实从一个框架设计者的角度上将，urlencode是每个请求都会用到的，很顺利的可以想到框架会包含这个urlencode功能，不需要编程人员将参数urlencode。

问题二：特殊字符串丢失描述
在使用restTemplate传递课件标题的时候，发现有一些特殊字符串有数据丢失问题，例如传递课件标题：开发测试001&aaa，接收方接到的是：开发测试001，后面跟的&aaa字符丢失了。
分析
再一次怀疑是restTemplate里面自带的编码导致的问题，于是对比了直接使用urlencode与使用restTemplate编码的结果，如下表：

urlencode	%e5%bc%80%e5%8f%91%e6%b5%8b%e8%af%95001%26aaa
restTemplate	%E5%BC%80%E5%8F%91%E6%B5%8B%E8%AF%95001&aaa

明显可以发现restTemplate对特殊字符“&”没有进行url编码，导致最后构建成的url是这样的：

http://xxx.com/slide/insertEmptySlide?businessLineId=1&slideTitle=%E5%BC%80%E5%8F%91%E6%B5%8B%E8%AF%95001&aaa

这样就会把&aaa中的aaa当成get请求中的一个参数来看待，从而得到的title只为：%E5%BC%80%E5%8F%91%E6%B5%8B%E8%AF%95001，导致丢失了&aaa字符，接收方解析也只能得到标题为：开发测试001。
结论
restTemplate在进行url编码的时候，不会对某些特殊字符的编码，例如&。
方案
既然restTemplate会忽略掉某些特殊字符的url编码，那么我们就索性不用restTemplate编码，直接自己编码好，跳过restTemplate的编码，实现方案为：

public String createPptSlide(String title) {UriComponentsBuilder builder = UriComponentsBuilder.fromHttpUrl(host + PPT_SLIDE_INSERT); builder.queryParam("businessLineId", PPT_BUSINESS_LINE_ID); builder.queryParam("slideTitle", title); URI uri = builder.build().encode().toUri(); restTemplate.getForEntity(uri, JSONObject.class); }

（ps：传String的url，restTemplate都会再一次进行编码，而直接传URI可以跳过restTemplate的编码）
以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。