Spring Boot之RestTemplate在URL中转义字符转义的问题解决

Spring Boot之RestTemplate在URL中转义字符转义的问题解决

相同代码在不同SpringBoot版本中使用RestTemplate请求时遇到的问题:

        Map<String, Object> param = new HashMap<String, Object>();
            param.put("version","2.0.0");
            String userSing = sign(param);
            param.put("user_sign", userSing);
            logger.info("签名:" + userSing);
            StringBuilder paramStr = new StringBuilder("?");
            for(Map.Entry<String, Object> entry : param.entrySet()){
                paramStr.append(entry.getKey()).append("=")
                        .append(entry.getValue() == null ? "" : String.valueOf(entry.getValue()))
                        .append("&");
            }
            paramStr.deleteCharAt(paramStr.length() - 1);
            logger.info("入参:" + paramStr.toString());
            RestTemplate restTemplate = new RestTemplate();
            String jsonStr = restTemplate.getForObject(sendMessagesUrl + paramStr.toString(), String.class);
            logger.info("响应值:" + jsonStr);

下面截图为springboot1.5.3 RestTemplate request log
Spring Boot之RestTemplate在URL中转义字符转义的问题解决

下面截图为springboot2.1.7 RestTemplate request log
Spring Boot之RestTemplate在URL中转义字符转义的问题解决

在这两份log中可以看到user_sign对应的value值中的 + 是特殊的字符,1.0版本的被转义为: %2B,2.0版本没有被转义,最终2.0版本程序的RestTemplate请求第三方在签名解码时校验不通过。

1.尝试与分析

根据上述信息我们可以圈定问题的范围,= 有被转码,说明可能是在RestTemplate中url参数的构建转码的方式上与httpClient有什么不通,尝试进行各类处理方法。
主要使用的方式有:

  • UriComponent构建uri(未解决)

2.跟踪RestTemplate源码

Spring Boot之RestTemplate在URL中转义字符转义的问题解决debug到这里时发现user_sign被转义了但 + 没有变。
Spring Boot之RestTemplate在URL中转义字符转义的问题解决这时URLDecoder.decode("/QaNSBls/U8ciXEWaCWtmeMK6+w%3D")会发现 + 变成了 空格,导致第三方在签名解码时校验不通过。

Spring Boot之RestTemplate在URL中转义字符转义的问题解决
Spring Boot之RestTemplate在URL中转义字符转义的问题解决再次通过比较会发现StringBoot2.0版本对应的URL转码 + 不会被解析。

经过多次百度有看到如下:

根据 RFC 3986 加号等符号的确实可以出现在参数中的,而且不需要编码,有问题的在于服务端的解析没有与时俱进

3.解决问题

最后解决一些这个问题,当使用RestTemplate发起请求,如果请求参数中有需要url编码时,通过如下两种方式解决:

  1. 不希望出现问题的使用姿势应传入URI对象而不是字符串,修改RestTemplate请求方法入参的String url 修改为 URI url
  2. 修改入参编码格式,然后在构建RestTemplate时,
  RestTemplate restTemplate = new RestTemplate();
            DefaultUriBuilderFactory uriFactory = new DefaultUriBuilderFactory();
            uriFactory.setEncodingMode(DefaultUriBuilderFactory.EncodingMode.VALUES_ONLY);
            restTemplate.setUriTemplateHandler(uriFactory);`

小结

注意SpringBoot2.0版本的url参数编码,默认只会针对 = 和 & 进行处理;为了兼容我们一般的后端的url编解码处理在需要编码参数时,个人建议尽量不要使用Spring默认的方式,不然接收到数据会和预期的不一致。

上一篇:RestTemplate:带 header 的 get 请求


下一篇:RestTemplate