Go path.Clean 怎样规范化 URL 路径片段

处理 URL 路径时，path.Clean 解决的是“字符串长什么样”的问题：合并连续斜杠、移除 . 段、按词法处理 .. 段，并把空结果变成 .。它不访问磁盘，也不知道某个目录是否存在，因此不能拿来代替文件检查或权限判断。

path.Clean 的工作范围：只做斜杠路径的词法规范化

Go 官方把 path 定位为处理正斜杠分隔的路径，例如 URL。最容易踩的坑是把它和 filepath.Clean 混用：前者面向 URL 或虚拟路径，后者才考虑操作系统路径分隔符。

例如，连续斜杠和点段可以直接归一化：

package main

import (
	"fmt"
	"path"
)

func main() {
	rawPath := "/api//v1/./users/../profile"
	// Clean 只按路径字符串的词法规则处理，不访问文件系统。
	cleanPath := path.Clean(rawPath)
	fmt.Println(cleanPath) // /api/v1/profile
}

这里的结果是 /api/v1/profile。规则可以记成：压缩重复斜杠，删除当前目录段，回退前一个普通段；如果是根路径开头，开头的 .. 不会把路径带到根目录之外。输入为空时返回 .，这也是为什么不能把空结果当成“没有路径”来猜。

把 URL 解析、路径清理和查询参数分成三层

path.Clean 不认识 URL 的查询串。若直接把 /api//v1?sort=desc 作为普通字符串清理，问号和查询内容会被当成路径字符的一部分，代码意图不清晰，后续也容易误改查询参数。更稳妥的方式是先解析 URL，只更新 Path：

package main

import (
	"fmt"
	"net/url"
	"path"
)

func main() {
	u, err := url.Parse("/api//v1/./users/../profile?sort=desc&page=2")
	if err != nil {
		// 解析失败时停止重组，避免把不完整输入当成合法路由。
		panic(err)
	}
	// 只规范化 URL 路径；RawQuery 保持为独立的查询部分。
	u.Path = path.Clean(u.Path)
	fmt.Println(u.String()) // /api/v1/profile?sort=desc&page=2
}

这段代码的关键不是“调用一次 Clean”，而是先把数据边界分开：Path 参与路径规范化，RawQuery 继续由 URL 解析器维护。实际项目若涉及百分号编码、保留字符或 RawPath，还要根据路由框架的编码约定做专门测试，不能只看打印出来的字符串。

参数与结果边界要在代码旁边写清楚

特别要注意，清理后的字符串不等于安全路径。若路径来自用户输入，权限判断应基于解析后的资源标识和业务根目录；如果需求是防止目录穿越，还要定义允许的根、拒绝相对路径的策略，并结合实际打开文件的方式验证。path.Clean 可以作为规范化步骤，但不是完整的安全边界。

上线前的 path.Clean 检查清单

可以把下面四项放进路由或路径工具的测试表：输入是否只含 URL 语义的正斜杠；查询串是否在清理前后保持独立；空串和相对 .. 是否符合业务约定；最终资源访问是否仍经过授权和存在性检查。对于 Windows 本地路径，再检查是否误把反斜杠交给了 path。

常见问题

path.Clean 会检查目录是否存在吗？

不会。它只返回词法规范化后的字符串，不执行 stat、打开文件或网络请求。

path.Clean 能直接清理完整 URL 吗？

不建议。先用 net/url 拆出路径，再清理 Path；协议、主机和查询参数不属于它的职责。

为什么相对输入清理后仍有 ..？

因为它不能凭空知道相对路径的根。相对路径的父目录段可能仍有意义，调用方需要按业务规则决定是否接受。