我不会使用URLEncoder。除了命名错误（URLEncoder与URL无关）、效率低下（它使用StringBuffer而不是Builder，并执行一些其他缓慢的操作），它也太容易出错。

相反，我将使用URIBuilder或Spring的org.springframework.web.util.UriUtils.encodeQuery或Commons Apache HttpClient。原因是您必须以不同于参数值的方式转义查询参数名称（即BalusC的答案q）。

上面的唯一缺点（我痛苦地发现）是URL不是URI的真正子集。

示例代码：

import org.apache.http.client.utils.URIBuilder;

URIBuilder ub = new URIBuilder("http://example.com/query");
ub.addParameter("q", "random word £500 bank \$");
String url = ub.toString();

// Result: http://example.com/query?q=random+word+%C2%A3500+bank+%24

代码

URL url = new URL("http://example.com/query?q=random word £500 bank $");
URI uri = new URI(url.getProtocol(), url.getUserInfo(), IDN.toASCII(url.getHost()), url.getPort(), url.getPath(), url.getQuery(), url.getRef());
String correctEncodedURL = uri.toASCIIString();
System.out.println(correctEncodedURL);

打印

http://example.com/query?q=random%20word%20%C2%A3500%20bank%20$

这里发生了什么？

1.将URL拆分为结构部分。对其使用java.net.URL。

2.正确编码每个结构部件！

3.使用IDN.toASCII（putDomainNameHere）对主机名进行Punycode编码！

4.使用java.net.URI.toASCIIString（）对NFC编码的Unicode进行百分比编码（最好是NFKC！）。有关详细信息，请参阅：如何正确编码此URL

在某些情况下，建议检查URL是否已编码。还将“+”编码空格替换为“%20”编码空格。

下面是一些同样可以正常工作的示例

{
      "in" : "http://نامه‌ای.com/",
     "out" : "http://xn--mgba3gch31f.com/"
},{
     "in" : "http://www.example.com/‥/foo",
     "out" : "http://www.example.com/%E2%80%A5/foo"
},{
     "in" : "http://search.barnesandnoble.com/booksearch/first book.pdf",
     "out" : "http://search.barnesandnoble.com/booksearch/first%20book.pdf"
}, {
     "in" : "http://example.com/query?q=random word £500 bank $",
     "out" : "http://example.com/query?q=random%20word%20%C2%A3500%20bank%20$"
}

该解决方案通过了Web平台测试提供的大约100个测试用例。

下面是一个方法，您可以在代码中使用该方法将URL字符串和参数映射转换为包含查询参数的有效编码URL字符串。

String addQueryStringToUrlString(String url, final Map<Object, Object> parameters) throws UnsupportedEncodingException {
    if (parameters == null) {
        return url;
    }

    for (Map.Entry<Object, Object> parameter : parameters.entrySet()) {

        final String encodedKey = URLEncoder.encode(parameter.getKey().toString(), "UTF-8");
        final String encodedValue = URLEncoder.encode(parameter.getValue().toString(), "UTF-8");

        if (!url.contains("?")) {
            url += "?" + encodedKey + "=" + encodedValue;
        } else {
            url += "&" + encodedKey + "=" + encodedValue;
        }
    }

    return url;
}

使用此项：URLEncoder.encode（查询，StandardCharsets.UTF_8.displayName（））；或者：URLEncoder.encode（查询，“UTF-8”）；您可以使用以下代码。字符串encodedUrl1=UriUtils.encodeQuery（查询，“UTF-8”）；//无变化字符串encodedUrl2=URLEncoder.encode（查询，“UTF-8”）；//改变字符串encodedUrl3=URLEncoder.encode（查询，StandardCharsets.UTF_8.displayName（））；//改变System.out.println（“url1”+encodedUrl1+“\n”+“url2”+“encodedUrl2+”\n“+”url3=“+encoded url3”）；

ApacheHttpComponents库为构建和编码查询参数提供了一个简单的选项。

对于HttpComponents 4.x，使用：

URLEncodedUtils公司

对于HttpClient 3.x，请使用：

编码Util

在我的例子中，我只需要传递整个URL，并只对每个参数的值进行编码。我找不到通用代码，所以（！！）所以我创建了一个小方法来完成这项工作：

public static String encodeUrl(String url) throws Exception {
    if (url == null || !url.contains("?")) {
        return url;
    }

    List<String> list = new ArrayList<>();
    String rootUrl = url.split("\\?")[0] + "?";
    String paramsUrl = url.replace(rootUrl, "");
    List<String> paramsUrlList = Arrays.asList(paramsUrl.split("&"));
    for (String param : paramsUrlList) {
        if (param.contains("=")) {
            String key = param.split("=")[0];
            String value = param.replace(key + "=", "");
            list.add(key + "=" +  URLEncoder.encode(value, "UTF-8"));
        }
        else {
            list.add(param);
        }
    }

    return rootUrl + StringUtils.join(list, "&");
}

public static String decodeUrl(String url) throws Exception {
    return URLDecoder.decode(url, "UTF-8");
}

它使用Apache Commons的org.Apache.mons.lang3.StringUtils。