Java中如何转义URL以同时适配HTML存储与URL编码需求？

看来你需要的是符合RFC 3986标准的URL编码，同时要保证编码后的字符串能在HTML中安全存储。Java自带的URLEncoder确实遵循application/x-www-form-urlencoded规范，会把空格转成+，这和你需要的%20格式不符，而且它更多是处理表单数据，不完全适配URL路径部分的编码需求。

方法一：手动实现核心特殊字符替换 #

如果你只需要处理常见的特殊字符（空格、&等），可以直接针对这些字符做定向替换，简单高效：

String originalUrl = "http://BUCKET_ENDPOINT/PATH_1/PATH_2/PATH_3/PATH_4/PATH_5/TEST NAME COULD BE WITH & AND OTHER SPECIAL CHARS.zip";

// 拆分URL的基础部分和路径部分，避免编码协议、域名
int pathStart = originalUrl.indexOf("/", 8); // 跳过"http://"前缀
String baseUrl = originalUrl.substring(0, pathStart);
String path = originalUrl.substring(pathStart);

// 对路径部分做RFC 3986风格编码
String encodedPath = path.replace(" ", "%20")
                         .replace("&", "%26")
                         .replace("#", "%23")
                         .replace("?", "%3F"); // 可根据需求添加更多特殊字符

String finalUrl = baseUrl + encodedPath;

这种方式编码后的%20、%26等格式，既符合URL规范，又能直接在HTML中安全存储（HTML对%没有特殊解析规则）。

方法二：用Java标准库实现完整RFC 3986编码 #

如果需要处理所有符合标准的特殊字符，推荐用URI类来构建URL，它会自动按照RFC 3986规则编码路径部分：

import java.net.URI;
import java.net.URISyntaxException;

public class UrlEncodingDemo {
    public static void main(String[] args) throws URISyntaxException {
        String originalUrl = "http://BUCKET_ENDPOINT/PATH_1/PATH_2/PATH_3/PATH_4/PATH_5/TEST NAME COULD BE WITH & AND OTHER SPECIAL CHARS.zip";
        
        URI uri = new URI(originalUrl);
        // 重新构建URI，确保路径、参数等部分被正确编码
        URI encodedUri = new URI(uri.getScheme(), 
                                 uri.getAuthority(), 
                                 uri.getPath(), 
                                 uri.getQuery(), 
                                 uri.getFragment());
        
        String finalUrl = encodedUri.toString();
        System.out.println(finalUrl);
    }
}

这个方法会自动把空格转成%20、&转成%26，完全符合标准URL编码要求，同时编码后的URL在HTML中也能直接使用——因为%26不会被HTML解析成&符号，无需额外转义成HTML实体&（如果要把URL放在HTML属性里，比如<a href="">，也可以直接用）。

补充：极端场景的HTML安全处理 #

如果你的场景要求绝对的HTML存储安全（比如URL可能包含其他HTML敏感字符），可以在URL编码完成后，再对HTML特殊字符做转义：

String htmlSafeUrl = finalUrl.replace("&", "&")
                             .replace("\"", """);

不过大部分情况下，经过RFC 3986编码后的URL已经满足HTML存储需求，不需要这一步额外操作。

内容的提问来源于stack exchange，提问作者Ohad Benita