Go url.URL EscapedPath 怎么保留合法 RawPath

我第一次遇到这个问题，是在一个对象存储路径里保留编码斜杠：原始 URL 写的是 /foo%2Fbar，但解析后的 Path 却变成了 /foo/bar。结论很简单：不要直接读 RawPath，输出路径时调用 u.EscapedPath()；如果自己改过 Path，就只保留仍然能解码回它的 RawPath。

合法的 RawPath 会被 EscapedPath 采用；RawPath 为空或不合法时，EscapedPath 会根据 Path 重新生成转义结果。String 和 RequestURI 也走这条规则。

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

Path、RawPath 和 EscapedPath 的分工

Go 的 url.URL 会把路径放在解码视图中，所以 %2F 与普通斜杠都可能表现为 /。这对路由匹配很方便，却无法单靠 Path 判断原始 URL 中哪一个斜杠曾经被编码。

RawPath 只有在“解码后确实等于 Path”时才有意义。例如 Path=/foo/bar、RawPath=/foo%2Fbar 是一对合法关系。读取时调用 EscapedPath，可以保留这个编码斜杠；直接读取 RawPath 则绕过了包提供的安全判断。

用 Parse 保留原始编码

解析输入 URL 时，不需要手动拆分百分号。下面的例子专门打印三个视图：业务判断看 Path，需要发请求或记录原始形式时看 EscapedPath。

package main

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

func main() {
    // Parse 保存解码后的 Path，并在 RawPath 中保留可用的编码提示。
    u, err := url.Parse("https://example.com/foo%2fbar")
    if err != nil {
        // 输入来自请求时应把解析错误交给上层，示例用日志直接退出。
        log.Fatal(err)
    }

    fmt.Println("Path:", u.Path)
    fmt.Println("RawPath:", u.RawPath)
    // EscapedPath 会先判断 RawPath 是否是 Path 的合法转义。
    fmt.Println("EscapedPath:", u.EscapedPath())
    // String 和 RequestURI 构造路径时也使用 EscapedPath 的结果。
    fmt.Println("String:", u.String())
    fmt.Println("RequestURI:", u.RequestURI())
}

这里 Path 适合做资源层级判断，EscapedPath 适合组装请求目标。不要把大小写差异当成数据丢失：%2f 与 %2F 解码后的字节相同，但合法的 RawPath 可以让原始写法继续参与输出。

手动改写路径时，如何保留合法 RawPath

URL 被路由拼接、租户前缀改写或重定向前缀替换后，最容易出现“Path 已经换了，RawPath 还停在旧值”。这时不要只赋值一个字段。要么清空 RawPath，让包按新 Path 重新转义；要么同步写入一个解码后恰好等于新 Path 的编码字符串。

// 保留编码斜杠：RawPath 解码后必须等于 Path。
u.Path = "/asset/a/b"
u.RawPath = "/asset/a%2Fb"
fmt.Println(u.EscapedPath()) // /asset/a%2Fb

// 如果不需要保留原始编码，清空提示最稳妥。
u.Path = "/asset/a/b"
u.RawPath = ""
fmt.Println(u.EscapedPath()) // /asset/a/b

如果把 RawPath 写成 /asset/a%2Fc，它解码后是另一个路径，EscapedPath 就会忽略这个提示。非法百分号也一样：它不会替你修正成“看起来像原始值”的结果，而是回退到基于 Path 的合法转义。

上线前的排查与回滚清单

线上看到路径形态变化时，我会先记录 Path、RawPath 和 EscapedPath 三个值，再检查下游使用的是 String、RequestURI 还是自拼字符串。可以按下面的顺序处理：

回滚也有一个简单原则：如果业务并不要求保留编码斜杠，就恢复为“只维护 Path、RawPath 置空”的方案；只有确实需要区分两种路径表示时，才承担同步 RawPath 的维护成本。

常见问题

为什么不直接读取 RawPath？

因为它是可选提示，可能为空，也可能已经与 Path 不匹配。EscapedPath 会替你做合法性判断。

Path 和 RawPath 必须同时设置吗？

不必须。只设置 Path 就能生成合法路径；只有要保留某种原始编码形式时，才设置对应的 RawPath。

RequestURI 会不会丢掉编码斜杠？

只要 RawPath 是 Path 的合法转义，RequestURI 会使用 EscapedPath 的结果；若提示失配，则会回退到 Path 的重新转义形式。