本文介绍使用 Java 的 java.nio.file.Path API 安全、跨平台地从 URL 路径中动态移除任意一级路径段（如 path1），保留协议、域名及剩余路径结构，适用于微服务路由处理、前端重写或后端路径规范化等场景。
本文介绍使用 java 的 `java.nio.file.path` api 安全、跨平台地从 url 路径中动态移除任意一级路径段（如 `path1`），保留协议、域名及剩余路径结构，适用于微服务路由处理、前端重写或后端路径规范化等场景。
在实际开发中，常需对 URL 进行路径级动态裁剪——例如将 https://example.com/context/path1/path2/path3 中的 path1 移除，得到 https://example.com/context/path2/path3。注意：这不是简单的字符串替换（易误删子串或破坏路径语义），而应基于标准路径层级结构进行精确匹配与重构。
Java 提供了 java.nio.file.Path 类，专为处理分层路径设计，天然支持跨操作系统（Windows/Linux/macOS）的路径解析与操作，是比正则或 String.split("/") 更健壮的选择。
以下为完整实现示例：
import java.net.URI;
import java.nio.file.Path;
import java.nio.file.Paths;
public class UrlPathRemover {
public static URI removePathSegment(URI originalUri, String segmentToRemove) {
if (originalUri == null || segmentToRemove == null) {
throw new IllegalArgumentException("URI and segment to remove must not be null");
}
// 解析原始路径（忽略查询参数和片段）
String path = originalUri.getRawPath(); // 使用 getRawPath() 保留编码字符（如 %20）
if (path == null || path.isEmpty()) {
return originalUri; // 无路径，无需修改
}
Path basePath = Paths.get(path);
Path resultPath = Paths.get("/"); // 初始化为根路径
// 遍历每一段路径名，跳过目标段
for (int i = 0; i <p>✅ <strong>关键优势说明</strong>： </p>
- ✅ 安全解码处理：使用
getRawPath()避免自动解码（如/user%2Fname不会错误变为/user/name）； - ✅ 严格字面匹配：仅当整段路径名完全等于
segmentToRemove时才跳过，避免path12被误删； - ✅ 保留权威信息：通过
getAuthority()正确提取 host、port 及用户信息（如user@host:8080）； - ✅ 边界兼容：支持根路径
/、空路径、带尾部斜杠等常见情况。
⚠️ 注意事项：
- 该方法默认只移除第一个匹配的路径段。如需移除所有同名段，可将
if (!name.equals(...))改为循环内持续累积； - 若 URL 含查询参数（
?q=1）或锚点（#section），当前实现会丢弃它们——如需保留，请在构造新 URI 时传入originalUri.getQuery()和originalUri.getFragment()； - 对于前端 JavaScript 场景，建议改用
URL和URL.pathnameAPI 实现类似逻辑，原理相通但语法不同。
掌握此模式后，你可轻松扩展为路径插入、替换、深度截断等高级 URL 操作，为构建灵活的网关、代理或 SPA 路由中间件打下坚实基础。
