Go语言如何解析URL参数_net url参数解析说明

url.ParseQuery适用于纯query字符串解析，返回map[string][]string并自动解码；完整URL需先url.Parse再取RawQuery解析；解析表单体同理，应避免req.ParseForm的副作用；需用values.Has或len判断参数是否存在而非仅依赖Get返回空字符串。

Go 里用 url.ParseQuery 解析 query string 最直接

如果你拿到的是纯 query 字符串（比如 "name=alice&age=30&tags=go&tags=web"），url.ParseQuery 是最轻量、最常用的方式。它返回 map[string][]string，自动处理重复 key 和 URL 解码。

注意：它不处理完整 URL，只吃 query 部分；如果传入带 ? 的字符串（如 "?name=alice"），会报错 invalid URL escape —— 因为 ? 不是合法的 query 字符。

query := "name=alice&age=30&tags=go&tags=web"
values, err := url.ParseQuery(query)
if err != nil {
    log.Fatal(err)
}
fmt.Println(values.Get("name"))     // "alice"（取第一个）
fmt.Println(values["tags"])         // ["go" "web"]
fmt.Println(values.Get("missing"))  // ""（空字符串，不会 panic）

url.Parse + .RawQuery 是解析完整 URL 的标准组合

当你面对的是完整 URL（如 "https://example.com/search?q=go&lang=zh"），必须先用 url.Parse 解析结构，再从 *url.URL 的 RawQuery 字段提取 query 字符串，最后交给 url.ParseQuery。

别直接用 u.Query() —— 它返回的是已解码后的 Values，但会丢失原始编码细节（比如空格被转成 + 还是 %20），且无法区分 key= 和 key（后者在 ParseQuery 中视为 key=""，而 u.Query() 会忽略无值 key）。

• u.RawQuery 保留原始字节，适合二次解析或透传
• u.Query() 适合快速读取，但语义模糊：它把 key= 和 key 都当成 key=""
• 如果 URL 含非法字符（如未编码的空格），url.Parse 会失败，需提前清理或容错

手动处理 application/x-www-form-urlencoded body 时也用 url.ParseQuery

HTTP POST 的表单数据（Content-Type: application/x-www-form-urlencoded）和 query string 格式完全一致，所以解析逻辑复用 —— 直接读 req.Body，再传给 url.ParseQuery 即可。

常见错误：调用 req.ParseForm() 后反复访问 req.PostForm，看似方便，实则有坑：

• 它会自动调用 ParseMultipartForm（即使不是 multipart），影响后续读取 Body
• 它把 query 和 body 混在一起塞进 req.Form，容易误读来源
• 若 body 已被读过（如中间件提前解析），ParseForm 会静默失败，PostForm 为空

更可控的做法是跳过 ParseForm，自己读 body 并解析：

body, _ := io.ReadAll(req.Body)
values, _ := url.ParseQuery(string(body))
name := values.Get("name")

中文、特殊字符和空值的边界情况必须测试

URL 参数中常见的 name=%E4%BD%A0%E5%A5%BD&empty=&blank，对应三种语义：

• name=%E4%BD%A0%E5%A5%BD → 解码后是 "你好"（ParseQuery 自动做）
• empty= → values["empty"] == []string{""}，Get("empty") 返回 ""
• blank（无等号）→ values["blank"] == []string{""}，行为和 blank= 一致

这意味着你无法单靠 values.Get(k) == "

" 判断参数是否存在 —— 它可能是空字符串、缺失、或只有 key 名。真要区分，得查 len(values[k]) > 0 或用 values.Has(k)（Go 1.19+）。

另外，%00、控制字符、超长 key 等异常输入可能触发解析失败，生产环境建议加 err 判断，而非忽略。