Go 的 url.Parse 不保证填充 URL.RawPath 字段，它仅作为可选提示；需始终使用 URL.EscapedPath() 获取可靠、符合规范的已编码路径。
go 的 `url.parse` 不保证填充 `url.rawpath` 字段，它仅作为可选提示；需始终使用 `url.escapedpath()` 获取可靠、符合规范的已编码路径。
在 Go 的 net/url 包中，URL.RawPath 常被误解为“原始未解码路径”的直接映射，但事实并非如此。根据官方文档，RawPath 是一个可选提示（encoded path hint），仅在 Go 1.5+ 引入，且其存在与否取决于解析时能否安全地将其与 URL.Path 保持一致——即：RawPath 必须是 Path 的合法 URL 编码形式，否则将被忽略（置为空字符串）。
关键规则如下：
- ✅ 若 RawPath 是 Path 的有效百分号编码（如 /foo%2fbar → Path="/foo/bar"），则 RawPath 会被保留；
- ❌ 若 RawPath 包含需双重编码的字符（如 %25 表示 %），则它不构成 Path 的合法编码（因为 % 在路径中必须被编码为 %25，而 Path 解码后不含裸 %），此时 RawPath 被清空，以避免歧义。
看两个典型对比：
package main
import (
"fmt"
"log"
"net/url"
)
func main() {
// 示例 1：%2f → '/'，是路径合法字符，RawPath 可保留
u1, _ := url.Parse("https://example.com/foo%2fbar")
fmt.Printf("✅ %s → Path: %q, RawPath: %q, EscapedPath(): %q\n",
u1.String(), u1.Path, u1.RawPath, u1.EscapedPath())
// 输出：Path: "/foo/bar", RawPath: "/foo%2fbar", EscapedPath(): "/foo%2fbar"
// 示例 2：%25 → '%'，而 '/' 后的 '%' 在路径中必须编码，但解码后 Path 不含裸 '%'，
// 所以 "/foo%25fbar" 无法无损还原为 Path → RawPath 被丢弃
u2, _ := url.Parse("https://example.com/foo%25fbar?q=morefoo%25bar")
fmt.Printf("❌ %s → Path: %q, RawPath: %q, EscapedPath(): %q, RawQuery: %q\n",
u2.String(), u2.Path, u2.RawPath, u2.EscapedPath(), u2.RawQuery)
// 输出：Path: "/foo%fbar", RawPath: "", EscapedPath(): "/foo%25fbar", RawQuery: "q=morefoo%25bar"
}
? 注意：u.Path 总是已解码的语义化路径（如 /foo/bar），而 u.EscapedPath() 总是返回符合 RFC 3986 的安全编码路径——它优先使用 RawPath（若合法），否则自动对 Path 进行标准编码。因此，无论 RawPath 是否为空，EscapedPath() 都是获取可靠原始编码路径的唯一正确方式。
此外，RawQuery 通常被正确填充，是因为查询参数的编码规则更宽松（且 url.Values.Encode 等工具默认生成合规编码），但这不改变 RawPath 的设计哲学：它不是存储原始输入的字段，而是优化场景下的可选缓存。
✅ 正确实践总结：
- 永远不要依赖 u.RawPath != "" 判断路径是否被编码；
- 需要序列化或比对原始路径字符串时，统一调用 u.EscapedPath()；
- 构造 URL 时，若需保留特定编码（如含 %25），应先设置 u.Path，再通过 u.EscapedPath() 获取结果，或手动设置 u.RawPath（但需自行确保其合法性）；
- 使用 url.URL.String() 时，底层会自动调用 EscapedPath() 和 RawQuery，因此输出始终是合法 URL。
遵循这一原则，可避免因路径编码不一致导致的代理转发失败、签名验证错误或 API 路由匹配异常等问题。
