Java中URLDecoder解码URL丢失查询参数，如何修复？

问题场景 #

现有一段Java URL解码代码：

public URL decodeURL(String url) {
    try {
        return new URL(URLDecoder.decode(url, StandardCharsets.UTF_8));
    } catch (MalformedURLException e) {
        throw new IllegalArgumentException(e.getMessage());
    }
}

测试URL："path/to/testurl/encoding?param=1&encodedQueryParam=table%3Dtask%5EORtableISEMPTY"

• 预期解码结果："path/to/testurl/encoding?param=1&encodedQueryParam=table=task^ORtableISEMPTY"
• 实际返回结果："/path/to/testurl/encoding"

问题原因 #

直接对整个URL字符串解码后传入URL构造器会触发两个核心问题：

1. URL类要求完整的URL格式（必须包含协议前缀，如http://、file://），无协议的相对URL会被异常解析，导致查询参数部分被丢弃。
2. 解码后的?和&会被URL构造器识别为URL结构分隔符，但缺少协议、主机等必要部分时，构造器无法正确识别查询参数段，仅保留路径部分。

修复方案 #

方案1：仅获取解码后的字符串（无需URL对象） #

如果只是需要解码后的文本内容，直接返回解码结果即可，无需构建URL对象：

public String decodeURLString(String url) {
    return URLDecoder.decode(url, StandardCharsets.UTF_8);
}

调用该方法后，将直接得到预期的完整解码字符串。

方案2：正确构建URL对象 #

若必须得到URL实例，需为解码后的字符串补充协议前缀，让URL构造器能正确解析全量内容：

public URL decodeURL(String url) {
    try {
        String decodedUrl = URLDecoder.decode(url, StandardCharsets.UTF_8);
        // 根据实际场景选择协议，比如本地文件用file://，网络地址用http://等
        return new URL("file:///" + decodedUrl);
    } catch (MalformedURLException e) {
        throw new IllegalArgumentException(e.getMessage());
    }
}

方案3：使用URI替代URL（更灵活的相对路径支持） #

URI类对相对路径的解析更友好，无需强制协议前缀：

public URI decodeURLToURI(String url) {
    try {
        String decodedUrl = URLDecoder.decode(url, StandardCharsets.UTF_8);
        return new URI(decodedUrl);
    } catch (URISyntaxException e) {
        throw new IllegalArgumentException(e.getMessage());
    }
}

后续可通过URI.toURL()方法转换为URL对象（需处理转换异常）。

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