Java与JavaScript URL编码结果不一致，需统一为含+的编码结果

问题背景 #

生成站点地图（sitemap）的URL时，Java后端与JavaScript前端的URL编码结果不一致，导致页面重定向至前端生成的URL，进而造成Google SEO排名下降。需要实现前后端编码结果统一，且偏好使用+代替%20作为空格的编码形式。

现有编码差异示例 #

Java 代码及结果 #

@Test
public void testUrl() {
    String s = "tata, abcd & xyz - 1/2kg ()";
    String encode = URLEncoder.encode(s, StandardCharsets.UTF_8);
    System.out.println(encode);
}

输出结果：tata%2C+abcd+%26+xyz+-+1%2F2kg+%28%29

JavaScript 代码及结果 #

encodeURIComponent("tata, abcd & xyz - 1/2kg ()");

输出结果：tata%2C%20abcd%20%26%20xyz%20-%201%2F2kg%20()

统一编码解决方案 #

前端（JavaScript）适配Java编码规则 #

Java的URLEncoder.encode遵循application/x-www-form-urlencoded规范，而JS的encodeURIComponent遵循RFC 3986规范，二者编码逻辑存在差异。要对齐结果，可在JS中实现以下适配函数：

function getSitemapEncodedUrl(str) {
    let encoded = encodeURIComponent(str);
    // 将空格编码从%20替换为+
    encoded = encoded.replace(/%20/g, '+');
    // 对()进行编码，对齐Java的URLEncoder行为
    encoded = encoded.replace(/\(/g, '%28').replace(/\)/g, '%29');
    return encoded;
}

// 测试验证
console.log(getSitemapEncodedUrl("tata, abcd & xyz - 1/2kg ()"));
// 输出：tata%2C+abcd+%26+xyz+-+1%2F2kg+%28%29

后端（Java）保持现有逻辑 #

Java端的URLEncoder.encode已满足需求中的编码偏好（用+代替空格），无需修改现有代码，维持原逻辑即可。

调整完成后，前后端生成的URL编码结果完全一致，可避免页面重定向问题，保障Google SEO排名不受影响。

内容的提问来源于stack exchange，提问作者Ravi Soni