必须检查 url.Parse 的错误,它不 panic 而是返回 nil 和 error;推荐用 url.ParseRequestURI 校验绝对 URI;取参数用 u.Query() 自动解码,拼路径用 url.JoinPath 或 u.ResolveReference。

直接用 url.Parse 解析字符串,但必须检查错误
Go 的 net/url 包里最常用的是 url.Parse,它把字符串转成 *url.URL 结构体。但这个函数不 panic,出错只返回 nil 和 error —— 很多人忽略错误检查,结果后续调用 u.Host 或 u.Path 时 panic。
- 必须判断
err != nil,不能只看返回值是否非 nil - 常见错误:传入空字符串、缺少协议(如
"example.com")、含非法字符(如未编码的空格) -
url.Parse不会自动补http://,"example.com"会解析失败
u, err := url.Parse("https://user:pass@example.com:8080/path?a=1#frag")
if err != nil {
log.Fatal(err) // 别跳过这步
}
fmt.Println(u.Scheme) // "https"
fmt.Println(u.User.Username()) // "user"
fmt.Println(u.Port()) // "8080"
url.ParseRequestURI 更严格,适合 HTTP 请求场景
如果目标是解析客户端发来的原始请求 URI(比如 GET /api/v1?x=1),或者你明确只要绝对 URI(带 scheme),就该用 url.ParseRequestURI。它拒绝相对路径和无 scheme 的输入,比 url.Parse 少一些“宽容”,更适合校验。
-
url.ParseRequestURI("/path?k=v")返回 error(缺 scheme) -
url.ParseRequestURI("https://a.b/c")成功 - HTTP 服务器中读取
r.RequestURI后,应优先用它而不是url.Parse - 注意:
ParseRequestURI不处理 fragment(#...),它会被丢弃
从 URL 中安全提取查询参数用 u.Query()
u.RawQuery 是原始字符串(如 "a=1&b=%20"),而 u.Query() 返回 url.Values,是自动解码后的 map[string][]string。这是最常用的取参方式,但要注意几个边界:
- 同一个 key 出现多次(
?a=1&a=2),u.Query().Get("a")只返回第一个值("1"),要用u.Query()["a"]拿全部 - 值含 % 编码(如
%20)会被自动解码,不需要手动url.QueryUnescape - 如果查询串为空或不存在,
u.Query()仍返回空 map,不会 panic
u, _ := url.Parse("https://x.y/z?q=hello%20world&tag=go&tag=web")
vals := u.Query()
fmt.Println(vals.Get("q")) // "hello world"
fmt.Println(vals["tag"]) // ["go" "web"]
fmt.Println(vals.Get("missing")) // ""(空字符串)
拼接 URL 时别手拼字符串,用 url.JoinPath 或 u.ResolveReference
手动拼 base + "/" + path 容易出错:重复斜杠、缺失分隔、路径含 .. 未清理、参数未编码。Go 1.19+ 提供了 url.JoinPath,专为路径拼接设计;已有 *url.URL 实例时,用 ResolveReference 更可靠。
立即学习“go语言免费学习笔记(深入)”;
-
url.JoinPath("https://a.b", "c", "d")→"https://a.b/c/d" -
url.JoinPath("https://a.b/c/", "../d")→"https://a.b/d"(自动清理) -
u.ResolveReference(&url.URL{Path: "sub/"})基于原 URL 解析相对路径 - 拼查询参数?还是走
u.Query().Set/ Add再赋回u.RawQuery
手动拼接 RawQuery 或 Fragment 时,记得用 url.QueryEscape 或 url.PathEscape 编码值,否则特殊字符会破坏结构。










