17370845950

Go 的 net/url 包需谨慎使用：缺失 scheme 时应补全再解析；Query 参数用 u.Query() 解码获取键值，u.RawQuery 保留原始编码；路径拼接须用 u.EscapedPath()；IPv6 下应通过 u.Hostname() 和 u.Port() 安全提取主机与端口。

Go 的 net/url 包能可靠解析标准 URL，但直接调用 url.Parse() 并不能解决所有常见需求——比如带中文路径、不规范的查询参数、或缺失 scheme 的字符串，都容易返回错误或产生意外结果。

url.Parse() 会因 scheme 缺失而失败

很多实际场景中，用户输入的是形如 example.com/path?k=v 或 //cdn.example.com/assets.js 这类无 scheme 的 URL 字符串。此时 url.Parse() 会返回 nil 和错误 parse "example.com/path": missing protocol scheme。

解决方法是先补全 scheme（如 https://），再解析；或者用 url.ParseRequestURI() 区分用途：

• url.Parse()：适用于已知完整 URL（含 scheme）且允许相对路径的场景（如重定向跳转逻辑）
• url.ParseRequestURI()：严格要求绝对 URI，拒绝相对路径，更适合校验用户输入的“完整地址”

若必须处理无 scheme 输入，建议手动前置判断并补全：

u, err := url.Parse("example.com/path?a=1")
if err != nil {
    u, err = url.Parse("https://" + "example.com/path?a=1")
}

Query 参数解析要调用 RawQuery 或 Query() 方法

url.Parse() 返回的 *url.URL 结构体中，RawQuery 是原始未解码的查询字符串（如 a=%E4%BD%A0%E5%A5%BD&b=2），而 Query() 方法才返回自动解码并解析为 url.Values（即 map[string][]string）的结果。

常见误区是直接读取 u.RawQuery 然后自己用 url.ParseQuery() 解析——这会导致重复解码或编码错误。

正确做法：

• 想获取键值对映射 → 用 u.Query()
• 想保留原始编码（如用于签名、透传）→ 用 u.RawQuery
• 想修改参数后重建 URL → 修改 u.Query() 返回值，再调用 u.RawQuery = u.Query().Encode()

示例：

u, _ := url.Parse("https://a.b/c?name=%E4%BD%A0&age=25")
vals := u.Query() // map[name:[你] age:[25]]
vals.Set("age", "26")
u.RawQuery = vals.Encode()
// u.String() → "https://a.b/c?age=26&name=%E4%BD%A0"

中文路径和特殊字符需注意 EscapedPath() 与 Path 字段区别

*url.URL 的 Path 字段是**已解码**后的路径（如 /你好），而 EscapedPath() 方法返回的是**URL 编码后可用于拼接的路径字符串**（如 /%E4%BD%A0%E5%A5%BD）。直接拼接 u.Path 到新 URL 中，会导致中文乱码或 400 错误。

典型错误场景：构造 redirect 地址时写成 "https://new.com" + u.Path —— 这会把未编码的中文塞进 URL。

安全做法：

• 拼接 URL 时，始终使用 u.EscapedPath() 或 url.PathEscape() 处理路径片段
• 从 u.Path 读取语义化路径（如日志、路由匹配）
• 注意 u.Path 开头恒为 /，即使原始 URL 是 http://x/y，它也是 /y

Host 和 Hostname() / Port() 的分离逻辑易被忽略

u.Host 是完整的 host:port 字符串（如 example.com:8080），但 u.Hostname() 和 u.Port() 才是拆解后的安全访问方式。直接对 u.Host 做字符串切分（如 strings.Split(u.Host, ":")）在 IPv6 地址下会出错（如 [::1]:8080）。

IPv6 支持是这里的关键差异点：

• u.Hostname() 正确剥离 IPv6 方括号和 port（返回 ::1）
• u.Port() 在有端口时返回数字字符串，无端口时返回空字符串
• u.Host 永远保持原始格式，不应直接用于网络拨号或 DNS 查询

例如，做代理转发时应这样提取目标地址：

host := u.Hostname()
port := u.Port()
if port == "" {
    port = "80"
    if u.Scheme == "https" {
        port = "443"
    }
}
target := net.JoinHostPort(host, port)

真正麻烦的不是解析本身，而是不同字段的编码状态、IPv6 格式兼容性、以及 scheme 缺失时的兜底策略——这些细节一旦漏掉，线上就容易出现 400、乱码或连接失败。