Go net/url.URL.RawPath 什么时候会影响 EscapedPath

Go 的 net/url 里，RawPath 只有在它确实是 Path 的一种有效转义形式时，才会影响 EscapedPath()。解析 URL 后，Path 通常已经是解码结果；需要保留原始路径编码时，应调用 EscapedPath()，不要直接把 RawPath 当作最终字符串。

最容易看出差异的例子是路径中的 %2F：它表示一个编码后的斜杠，但不能简单等同于路径分隔符。

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

先分清 Path、RawPath 与 EscapedPath

可以先把三个概念放到同一张表里。Path 是程序更容易处理的解码形式，RawPath 是可选的编码提示，EscapedPath() 则是面向 URL 输出的安全入口。

官方实现的判断规则很明确：如果 RawPath 能有效表示当前 Path，EscapedPath() 就返回它；否则忽略 RawPath，根据 Path 重新生成编码结果。

解析含 %2F 的 URL 时为什么 Path 看起来变了

解析 https://example.com/x/y%2Fz 后，Path 会显示为 /x/y/z，而 RawPath 仍可能保留 /x/y%2Fz。这不是数据丢失，而是标准库同时保存了“便于处理的路径”和“可用于还原编码形式的提示”。

package main

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

func main() {
	// %2F 是编码后的斜杠，用来观察 Path 与原始编码的差别。
	u, err := url.Parse("https://example.com/x/y%2Fz")
	if err != nil {
		log.Fatal(err) // 解析失败时停止，避免继续使用不完整的 URL。
	}

	// Path 适合做语义判断，EscapedPath 适合重新放回 URL 文本。
	fmt.Println("Path:", u.Path)
	fmt.Println("RawPath:", u.RawPath)
	fmt.Println("EscapedPath:", u.EscapedPath())
	fmt.Println("String:", u.String())
}

预期的字段关系是：Path 看到解码后的斜杠，EscapedPath() 仍能返回 /x/y%2Fz。而 String() 会使用 EscapedPath() 组装 URL，所以不要先读取 RawPath 再自行拼接。

手动构造 URL 并判断 RawPath 是否有效

手动给结构体赋值时，RawPath 不能与 Path 随意组合。下面第一组是互相匹配的编码提示，第二组故意放入与 Path 不一致的提示：

package main

import (
	"fmt"
	"net/url"
)

func main() {
	// 有效 RawPath 能表示同一个 Path，EscapedPath 会保留这份编码形式。
	valid := &url.URL{
		Scheme:  "https",
		Host:    "example.com",
		Path:    "/x/y/z",
		RawPath: "/x/y%2Fz",
	}
	fmt.Println(valid.EscapedPath())

	// 无效 RawPath 与 Path 对不上，会被 EscapedPath 忽略并重新编码。
	invalid := &url.URL{
		Path:    "/x/y/z",
		RawPath: "/x/y%2Fother",
	}
	fmt.Println(invalid.EscapedPath())
}

这个例子里，第一处输出会保留 %2F；第二处不会盲信 RawPath，而是按 Path 重新计算。也就是说，RawPath 是“提示”，不是绕过一致性判断的强制输出字段。

生产代码中什么时候该调用哪个成员

可以按“内部判断”和“对外编码”分工：

• 判断路径包含哪些目录或资源名时，优先使用 Path。
• 需要把 URL 重新序列化、生成请求目标或记录编码后的路径时，调用 EscapedPath()、String() 或 RequestURI()。
• 只有在确实需要构造保留编码形式的 URL 时，才手动维护 RawPath，并保证它与 Path 表示同一路径。

不要把 RawPath 当作普通缓存字段随意修改，也不要用字符串替换代替 URL 解析。这样做容易让 Path 和编码形式失配，最后由 EscapedPath() 回退到另一种结果。对大多数业务代码来说，读取 Path 做判断、调用 String() 或 EscapedPath() 做输出，就是最稳妥的边界。

常见追问

RawPath 为空时 EscapedPath 会返回什么？

它会根据 Path 计算一种合法的编码形式，不需要调用方手动填充 RawPath。

为什么不直接读取 RawPath？

因为它是可选提示，可能为空，也可能已经与当前 Path 不一致。官方建议通过 EscapedPath() 获取最终编码路径。