Go URL.Path 和 EscapedPath 有什么区别

如果 URL 路径里出现 %2F、中文或空格，URL.Path 和 URL.EscapedPath() 看到的内容可能不同。简单记法是：Path 用来理解“路径代表什么”，EscapedPath() 用来保留“请求线上怎样编码”。做路由语义判断通常读 Path，做签名、代理转发或记录原始路径时优先读 EscapedPath()。

官方文档：https://pkg.go.dev/net/url#URL.EscapedPath

先看同一个 URL 的两种路径视图

最容易暴露差异的输入是把斜杠写成 %2F。它仍然属于路径中的转义字符，但一旦解析到 Path，Go 会把它还原为斜杠；这时仅比较 Path，就无法知道某个斜杠原来是字面量还是编码结果。

package main

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

func main() {
    // 用编码斜杠制造一个需要区分语义与表示的路径。
    u, err := url.Parse("https://example.com/x/y%2Fz")
    if err != nil {
        // 解析失败时立即停止，避免继续读取不完整的 URL。
        log.Fatal(err)
    }

    // Path 适合做解码后的资源语义判断。
    fmt.Println("Path:", u.Path)
    // EscapedPath 适合查看请求路径的转义表示。
    fmt.Println("EscapedPath:", u.EscapedPath())
}

在这个例子里，Path 是 /x/y/z，而 EscapedPath() 是 /x/y%2Fz。这不是两个不同的 URL，而是同一个解析结果的语义视图和编码视图。

Path 和 EscapedPath 分别回答什么问题

URL 的 Path 保存解码后的路径；官方文档特别提醒，解码后无法区分原始 URL 中的字面斜杠与 %2F。因此，路由层要判断资源层级、提取目录或匹配已经解码的业务标识时，读 Path 更直接。

EscapedPath() 返回 Path 的转义形式。如果 RawPath 是 Path 的合法编码提示，它会优先返回 RawPath；否则忽略无效提示并重新计算。调用方法比直接读取 RawPath 更稳妥，因为 RawPath 是可选字段，不应被当作永远存在的原文副本。

请求拼接时不要把 RawPath 当成公共 API

如果要把解析结果发回 HTTP 请求，通常直接使用 String() 或 RequestURI()。前者重建完整 URL，后者返回请求行需要的编码路径和查询部分。两者都会使用 EscapedPath()，因此能延续合法的编码提示。

func showRequestForm(raw string) {
    // 解析输入后统一从方法获取请求表示，避免手工拼接百分号编码。
    u, err := url.Parse(raw)
    if err != nil {
        fmt.Println("invalid URL:", err)
        return
    }

    // String 保留 scheme、host、path 和 query 的完整结构。
    fmt.Println("full:", u.String())
    // RequestURI 只取 HTTP 请求中的 path?query 部分。
    fmt.Println("request:", u.RequestURI())
}

这段代码的重点是职责分开：业务判断使用 Path，发请求或做签名时先确定协议要求，再使用完整重建结果或 EscapedPath()。如果代码手工对 Path 再调用一次不匹配的转义函数，可能出现重复编码或斜杠语义变化。

按使用场景选择字段

可以用下面的判断收口：你是在问“资源是什么”，还是在问“线上字节怎样写”。前者倾向 Path，后者倾向 EscapedPath()；完整 URL 输出交给 String()。

• 路由匹配和资源层级：读取 Path，再按业务规则处理分段。
• 签名、代理和审计日志：先确认协议需要的规范，再读取 EscapedPath()，不要直接拿 RawPath。
• 完整地址重建：使用 String()；仅构造 HTTP 请求目标时使用 RequestURI()。
• 只处理查询参数：这是另一条边界，应使用 Query() 或 RawQuery，不要把它和本文的路径字段混为一谈。

常见问题

Path 变成了多一个斜杠，是解析错了吗？

不一定。%2F 在 Path 中会解码为斜杠，这是字段语义决定的；需要保留编码差异时改读 EscapedPath()。

为什么不直接读取 RawPath？

RawPath 是可选的编码提示，而且可能不符合当前 Path。官方建议调用 EscapedPath()，由它判断提示是否有效。

PathEscape 能替代 EscapedPath 吗？

不能直接替代。PathEscape 用来编码一个路径段；EscapedPath() 是基于已解析 URL 的整段路径表示，两者处理对象和语义不同。