兼容旧Java版本的已弃用URL(URL,String)构造器替代方案

问题背景 #

Java 21中new URL(URL context, String spec)构造器被标记为弃用，最初尝试用context.toURI().resolve(spec).toURL()作为替代，但该方法仅在Java 21中能和原构造器保持一致结果，在Java 11、17等旧版本中存在解析差异，甚至对非标准输入（如\foo）直接抛出异常——而原构造器和浏览器都能正常处理这类输入。

差异复现 #

测试代码 #

URL context = new URI("http://example.com").toURL();
for (String spec : Arrays.asList("foo", "/foo", "http://foo.bar", "\\foo")) {
    System.out.println(new URL(context, spec));
    System.out.println(context.toURI().resolve(spec));
}

Java 11/17运行输出 #

http://example.com/foo
http://example.comfoo
http://example.com/foo
http://example.com/foo
http://foo.bar
http://foo.bar
http://example.com/\foo
Exception in thread "main" java.lang.IllegalArgumentException: Illegal character in path at index 0: \foo
    at java.base/java.net.URI.create(URI.java:906)
    at java.base/java.net.URI.resolve(URI.java:1089)
    at Main.main(Main.java:10)
Caused by: java.net.URISyntaxException: Illegal character in path at index 0: \foo
    at java.base/java.net.URI$Parser.fail(URI.java:2974)
    at java.base/java.net.URI$Parser.checkChars(URI.java:3145)
    at java.base/java.net.URI$Parser.parseHierarchical(URI.java:3227)
    at java.base/java.net.URI$Parser.parse(URI.java:3186)
    at java.base/java.net.URI.<init>(URI.java:623)
    at java.base/java.net.URI.create(URI.java:904)
    ... 2 more

差异原因 #

URL构造器的解析逻辑更宽松：会直接保留非标准字符（如反斜杠），并按相对路径规则拼接；而URI.resolve严格遵循RFC 3986规范，会校验输入合法性，遇到非法字符直接抛出异常，且对无斜杠的相对路径（如foo）拼接规则和URL不同。

跨版本兼容解决方案 #

方案1：完全复刻原URL解析逻辑 #

利用未被弃用的URL带URLStreamHandler的构造器，直接复用原生解析逻辑，在所有Java版本中行为完全一致，包括处理非标准输入：

public static URL resolveURL(URL context, String spec) throws MalformedURLException {
    return new URL(context, spec, new URLStreamHandler() {
        @Override
        protected URLConnection openConnection(URL u) throws IOException {
            // 仅用于解析URL，无需实现连接逻辑
            throw new UnsupportedOperationException();
        }
    });
}

方案2：预处理输入+URI解析（无依赖） #

若需避免依赖URL构造器相关逻辑，可先对输入做标准化处理，再用URI.resolve实现等效解析：

public static URL resolveURL(URL context, String spec) throws MalformedURLException, URISyntaxException {
    // 将反斜杠替换为斜杠，匹配浏览器和原URL构造器的处理逻辑
    String normalizedSpec = spec.replace('\\', '/');
    URI contextUri = context.toURI();
    
    // 修复相对路径拼接差异：确保上下文路径以斜杠结尾
    if (!normalizedSpec.startsWith("/") && !normalizedSpec.contains("://")) {
        String contextPath = contextUri.getPath();
        if (!contextPath.endsWith("/")) {
            contextUri = new URI(
                contextUri.getScheme(),
                contextUri.getAuthority(),
                contextPath + "/",
                null,
                null
            );
        }
    }
    
    URI resolvedUri = contextUri.resolve(normalizedSpec);
    return resolvedUri.toURL();
}

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