如何从URL字符串中移除指定参数？有没有更优的Java实现方案？

原有实现的问题 #

• 匹配逻辑错误：用contains(key)判断参数是否需要删除过于粗糙，如果有参数名前缀和目标key一致（比如要删param2但存在param22参数），或者参数值中包含key字符串，都会出现误删/漏删
• 边界情况未处理：如果原URL没有查询参数、参数全部被删除、URL携带锚点（#后的内容）时，会出现数组越界、结果末尾残留多余?、锚点丢失的问题
• 不支持特殊场景：无法处理同key多值（比如param2=v1&param2=v2）、URL编码参数的场景

优化实现（纯JDK无第三方依赖） #

用Java标准库的java.net.URI类解析URL，从根源上避免手动拆分字符串的各种边界问题，代码如下：

import java.net.URI;
import java.net.URISyntaxException;
import java.util.Arrays;
import java.util.stream.Collectors;

private String removeParameter(String url, String keyToRemove) throws URISyntaxException {
    URI uri = new URI(url);
    String query = uri.getQuery();
    if (query == null || query.isEmpty()) {
        // 原URL无查询参数，直接返回
        return url;
    }
    // 过滤掉key匹配的参数，严格匹配参数名
    String newQuery = Arrays.stream(query.split("&"))
            .filter(param -> {
                int eqIdx = param.indexOf('=');
                String paramKey = eqIdx == -1 ? param : param.substring(0, eqIdx);
                return !paramKey.equals(keyToRemove);
            })
            .collect(Collectors.joining("&"));
    // 重构URI
    URI newUri = new URI(
            uri.getScheme(),
            uri.getAuthority(),
            uri.getPath(),
            newQuery.isEmpty() ? null : newQuery,
            uri.getFragment()
    );
    return newUri.toString();
}

该实现兼容所有常见边界场景：无参数、删完所有参数、带锚点、同key多值的场景都能正确处理，参数名严格匹配不会出现误删。

更简便的第三方工具实现（可选） #

如果项目已经引入相关依赖，用现成的工具类代码更简洁：

Apache HttpComponents URIBuilder #

import org.apache.http.client.utils.URIBuilder;

private String removeParameter(String url, String keyToRemove) throws Exception {
    URIBuilder uriBuilder = new URIBuilder(url);
    uriBuilder.removeParameters(keyToRemove);
    return uriBuilder.build().toString();
}

Spring UriComponentsBuilder #

import org.springframework.web.util.UriComponentsBuilder;

private String removeParameter(String url, String keyToRemove) {
    return UriComponentsBuilder.fromUriString(url)
            .replaceQueryParam(keyToRemove) // 仅传参数名不传值即代表移除该参数
            .build()
            .toUriString();
}

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