URIBuilder重复编码已转义URL参数问题咨询

这是个很常见的URL编码工具使用误区，我来帮你拆解原因和解决办法！

为什么会出现重复编码？ #

URIBuilder的核心设计逻辑就是自动帮你处理参数的URL编码——当你通过addParameter传入参数值时，它会把所有非URL安全的字符（包括%本身）都进行编码。所以你传入已经编码好的%0A时，它会把%当成普通字符，编码成%25，最终就变成了%250A。

两种可行的解决方案 #

方案1：传入原始未编码的参数值（推荐）

既然URIBuilder会自动编码，那直接把原始的换行符（\n）传入参数值，让工具帮你完成编码即可，这样既符合工具的设计逻辑，也不会出错：

// 示例代码
URIBuilder builder = new URIBuilder("你的基础URL");
// 直接使用原始换行符\n，URIBuilder会自动编码为%0A
builder.addParameter("text", "Congratulations! You are eligible for.\n");
URI url = builder.build();

生成的URL里，\n会被正确编码为%0A，其他特殊字符比如!也会被自动处理成%21，完全符合你的需求。

方案2：直接设置已编码的查询字符串（适合特殊场景）

如果你因为某些原因必须使用已经编码好的查询内容，可以跳过addParameter，直接用setQuery方法设置完整的已编码查询字符串，这样URIBuilder不会对这部分内容再次编码：

// 示例代码
String preEncodedQuery = "text=Congratulations%21+You+are+eligible+for+.%0A";
URIBuilder builder = new URIBuilder("你的基础URL");
builder.setQuery(preEncodedQuery);
URI url = builder.build();

这种方式适合你已经提前处理好所有编码逻辑的场景，但要注意确保查询字符串本身是合法的，避免出现编码错误。

总结 #

优先选择方案1，让URIBuilder帮你处理编码工作，这是最稳妥的方式。只有在特殊需求下，再考虑方案2手动传入已编码的查询内容。

内容的提问来源于stack exchange，提问作者Shiladittya Chakraborty