【开发心得】RestTemplate 自动 URLEncode导致特殊符号被转码问题

前言:

       最近在做抖音视频上传对接，场景是后端方式进行远程调用抖音开放能力，涉及到一个小问题，即分片上传时，upload_id需要encoder。ok，那么，手动给这个参数进行encode，然后问题来了，笔者使用的是resttemplate的postForObject()方法，第一个参数使用String方式传递的参数,执行该方法的时候，发现%符号被二次encode了，好家伙。(一开始没注意到，后来debug=true开启之后，看到了详细请求信息，注意到了这个问题)

 

 参考，使用UriComponentsBuilder 构建即可。

UriComponentsBuilder builder = UriComponentsBuilder.fromHttpUrl(serverUrl+partUploadComplete).queryParam("open_id",urlParam.getOpenId()).queryParam("access_token",urlParam.getAccessToken());
        builder.queryParam("upload_id",urlParam.getUpload_id());
        URI uri = builder.build(true).toUri();

究其原因，是UriString构建的操作在org.springframework.web.util.HierarchicalUriComponents类中的toUriString()方法中，其直接进行的字符串的拼接，而非进行encode。

源码如下:

public String toUriString() {
        StringBuilder uriBuilder = new StringBuilder();
        if (this.getScheme() != null) {
            uriBuilder.append(this.getScheme()).append(':');
        }

        if (this.userInfo != null || this.host != null) {
            uriBuilder.append("//");
            if (this.userInfo != null) {
                uriBuilder.append(this.userInfo).append('@');
            }

            if (this.host != null) {
                uriBuilder.append(this.host);
            }

            if (this.getPort() != -1) {
                uriBuilder.append(':').append(this.port);
            }
        }

        String path = this.getPath();
        if (StringUtils.hasLength(path)) {
            if (uriBuilder.length() != 0 && path.charAt(0) != '/') {
                uriBuilder.append('/');
            }

            uriBuilder.append(path);
        }

        String query = this.getQuery();
        if (query != null) {
            uriBuilder.append('?').append(query);
        }

        if (this.getFragment() != null) {
            uriBuilder.append('#').append(this.getFragment());
        }

        return uriBuilder.toString();
    }