Go url.RawPath 设置后为什么可能被 EscapedPath 忽略

url.RawPath 设置后仍可能被 EscapedPath 忽略，因为它不是强制使用的最终路径，而只是 Path 的可选编码提示。只有当 RawPath 是有效的路径编码，并且反转义后的字符串与 Path 完全相等时，EscapedPath() 才会原样返回它；任一条件失败，Go 都会从 Path 重新计算转义结果。

判断规则：RawPath 不是强制输出字段

URL.Path 是解码后的值。比如原始 URL 中的路径是 /x/y%2Fz，解析后 Path 可以是 /x/y/z，而 RawPath 保留 /x/y%2Fz，用于区分“原本就是斜杠”和“由 %2F 解码得到的斜杠”。

官方实现的判断可以概括成两个门槛：

1. RawPath 必须是路径上下文中可接受的编码形式；
2. 对它反转义后，结果必须严格等于 Path。

满足时返回 RawPath；否则调用路径转义逻辑处理 Path。因此，手工赋值成功并不代表该提示一定被采用。

三种状态对照：什么时候采用，什么时候忽略

下面用三个 URL 值对比合法编码、语义不一致和非法百分号转义。示例直接调用 EscapedPath，不把 RawPath 字段本身当作最终答案：

package main

import (
    "fmt"
    "net/url"
)

func main() {
    // RawPath 反转义后等于 Path，因此保留 %2F。
    accepted := url.URL{Path: "/x/y/z", RawPath: "/x/y%2Fz"}
    fmt.Println(accepted.EscapedPath())

    // 反转义结果是 /x/z，与 Path 不一致，因此忽略 RawPath。
    mismatch := url.URL{Path: "/x/y", RawPath: "/x%2Fz"}
    fmt.Println(mismatch.EscapedPath())

    // %ZZ 不是合法百分号转义，因此同样回退到 Path。
    invalid := url.URL{Path: "/x/y", RawPath: "/x/%ZZ/y"}
    fmt.Println(invalid.EscapedPath())
}

第一种情况需要保留非默认编码，所以 EscapedPath() 会返回 /x/y%2Fz。后两种情况都从 Path 生成 /x/y。这个回退不会返回错误；它的目标是始终给调用者一个可用的编码路径。

修正写法：修改 Path 后清空或重建 RawPath

最常见的故障是先解析一个带非默认转义的 URL，随后只修改 Path，却留下与新语义不一致的旧 RawPath。迁移时应把 Path 当作语义源；不要求保留特殊编码时，直接清空提示字段：

func buildRequestURI() (string, error) {
    u, err := url.Parse("https://example.com/x/y%2Fz")
    if err != nil {
        return "", err
    }

    // Path 改变后，旧 RawPath 已不再描述新路径，清空后让 Go 重新转义。
    u.Path = "/files/报告.pdf"
    u.RawPath = ""

    return u.RequestURI(), nil
}

如果业务确实要保留一种非默认编码形式，就同时维护二者：先确定解码后的 Path，再提供能反转义回该值的 RawPath。最终仍以 EscapedPath()、String() 或 RequestURI() 的返回值为准，而不是直接读取 RawPath。

迁移检查清单

• 旧代码若直接读取 RawPath，改为调用 EscapedPath()。
• 修改 Path 时，同步清空或重建 RawPath。
• 需要保留 %2F 等非默认表示时，确认反转义结果与 Path 完全一致。
• 组装完整 URL 时检查 String()；构造 HTTP 请求目标时检查 RequestURI()。
• 不要把 QueryEscape 用在路径上；查询参数和路径采用的转义规则不同。

相关问题

RawPath 为空是不是异常？

不是。它是可选字段。当默认转义足以表达 Path 时，保持空值最简单，EscapedPath 会自动生成编码路径。

为什么 url.Parse 有时会填 RawPath，有时不会？

当输入路径使用了需要保留的非默认编码形式时，解析器会保存提示；如果输入与默认编码一致，就没有必要额外保存。

URL.String 会直接拼接 RawPath 吗？

不会。它调用 EscapedPath()，所以无效或语义不一致的 RawPath 仍会被忽略。

RawPath 被忽略会返回错误吗？

不会。EscapedPath() 会静默回退到对 Path 的转义。需要排查时，应同时记录 Path、RawPath 和 EscapedPath() 的结果。