Go http.Request.URL.Path 为什么和 RawPath 不一样

如果你在 Go 的 http.Request 里看到 URL.Path 是 /x/y/z，而 URL.RawPath 却是 /x/y%2Fz，这通常不是解析错误。Path 保存的是解码后的路径，RawPath 只在需要保留原始转义形式时作为可选提示；要重新得到可用于 URL 文本的路径，应优先调用 EscapedPath()。

官方资料：https://pkg.go.dev/net/url#URL

记住一个判断：业务路由通常看 Path，需要保留原始编码或重建请求时看 EscapedPath()；不要把“RawPath 为空”当成“路径没有编码”。

先看清 Path 与 RawPath 的分工

排查这类问题时，最容易犯的错是把两个字段都当作“原始 URL”。实际上，Path 存储的是解码后的路径，所以 /x/y%2Fz 里的编码斜杠会表现为 /x/y/z。这样做便于普通路由使用，但也意味着只看 Path 无法判断某个斜杠原来是字符还是转义结果。

package main

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

func main() {
    // %2F 表示编码后的斜杠，用来观察解码值与原始提示的差异。
    parsed, err := url.Parse("https://example.com/x/y%2Fz")
    if err != nil {
        // 解析失败时停止继续使用不完整的 URL。
        log.Fatal(err)
    }
    fmt.Println("Path:", parsed.Path)
    fmt.Println("RawPath:", parsed.RawPath)
    // EscapedPath 会返回与 Path 一致的有效转义形式。
    fmt.Println("EscapedPath:", parsed.EscapedPath())
}

这段示例的重点不是打印本身，而是确认信息层次：Path 适合做解码后的业务判断，RawPath 不能脱离 Path 单独解释，EscapedPath() 才是对外重新表达路径时更稳妥的入口。

为什么不能直接依赖 RawPath

RawPath 是 optional encoded path hint，也就是“可选的编码路径提示”。它只有在确实是 Path 的有效转义形式时才有意义。若代码修改了 Path，却继续保留一段不匹配的 RawPath，EscapedPath() 会忽略这个无效提示并重新计算转义结果。

因此，读取路径时直接写 if u.RawPath != "" 并不可靠：它只能说明结构体里有提示，不能说明这段提示会被采用。希望保留原始编码时，调用 EscapedPath()；希望改变路径时，优先修改 Path，不要手工拼 RawPath。

重建 HTTP 请求时应该调用哪个值

如果只是根据请求资源做业务分支，通常使用 req.URL.Path。如果要记录、签名、生成请求行或把 URL 再交给客户端，则使用 req.URL.EscapedPath() 或让 req.URL.String() 负责组装。这样可以保留编码斜杠与普通斜杠的区别，避免先把路径解码再重新拼接造成语义变化。

func requestTarget(reqURL *url.URL) string {
    // RequestURI 使用 URL 的有效转义路径来构造请求目标。
    target := reqURL.RequestURI()
    if target == "" {
        // 空目标不应被当作普通绝对路径继续发送。
        return "/"
    }
    return target
}

这里不把 Path 直接拼成 "?" + RawQuery，也不把 RawPath 当成永远可信的字符串。标准库方法会根据字段之间的一致性决定采用提示还是重新转义。

常见问题

为什么 Path 看不到 %2F？ 因为 Path 按解码后的语义保存路径；需要原始编码时使用 EscapedPath。

RawPath 为空是不是丢失了请求信息？ 不一定。它是可选提示，EscapedPath 可以根据 Path 重新计算有效形式。

修改 Path 后要不要同步修改 RawPath？ 不建议手工同步。修改 Path 后通过 EscapedPath、String 或 RequestURI 重新生成表达，避免两者不一致。

路由匹配应该看哪个字段？ 取决于路由协议是否区分编码斜杠；普通业务判断常看 Path，需要保留传输层编码时应明确使用 EscapedPath。