Golang获取HTTP参数的几种方法

本文深入解析了在 Go 语言中正确获取 HTTP 请求各类参数的核心方法与常见陷阱：强调应直接使用 `r.URL.Query()` 安全提取 query 参数，而非误用 `r.FormValue()`；明确指出 `r.FormValue()` 在 POST 场景下必须先调用 `r.ParseForm()`（或 `r.ParseMultipartForm()`）才有效，且其会按 body > query 优先级合并解析；针对 JSON 请求，必须绕过表单解析、手动通过 `json.Decode(r.Body)` 解码，并警惕 `r.Body` 的一次性读取特性；最后指出标准库不支持路径参数（如 `/user/{id}`），需借助 chi、gorilla/mux 等路由库实现安全可靠的参数提取——掌握这些差异与时机，是写出健壮、可维护 Go Web 接口的关键。

query参数用 r.URL.Query() 获取，不是 r.FormValue()

很多人一上来就调用 r.FormValue("key") 想取 query 参数，结果在 POST 请求中拿不到值——因为 FormValue 会先尝试解析 body（如 application/x-www-form-urlencoded），再 fallback 到 URL query，但前提是没显式调用过 r.ParseForm() 或 r.ParseMultipartForm()。更稳妥、语义更清晰的做法是直接从 URL 解析：

values := r.URL.Query()
name := values.Get("name") // 单值
names := values["name"]    // 多值 slice

注意 Get() 对重复 key 只返回第一个，values["key"] 才拿到全部。

r.ParseForm() 之后才能用 r.FormValue() 读 body 和 query 混合参数

如果接口同时支持 GET 查询参数和 POST 表单数据（比如前端用 fetch 发 POST /api?debug=1），必须先调用 r.ParseForm()，否则 r.Form 是空的，r.FormValue() 也返回空字符串。

err := r.ParseForm()
if err != nil {
    http.Error(w, "bad form", http.StatusBadRequest)
    return
}
// 此时 FormValue 同时查 query 和 body（按优先级：body > query）
value := r.FormValue("id") // 来自 ?id=123 或 body 中 id=123

注意：对 multipart/form-data，要改用 r.ParseMultipartForm()；对 JSON 请求体，ParseForm() 不起作用，得自己 json.Decode(r.Body)。

JSON 请求体不能靠 ParseForm，得手动 json.Decode

当 Content-Type 是 application/json 时，r.ParseForm() 完全无效，r.FormValue() 和 r.Form 都为空。必须读取 r.Body 并解码：

var req struct {
    Name string `json:"name"`
    Age  int    `json:"age"`
}
err := json.NewDecoder(r.Body).Decode(&req)
if err != nil {
    http.Error(w, "invalid json", http.StatusBadRequest)
    return
}

别忘了 r.Body 只能读一次，如果之前调用了 r.ParseForm() 或其他读 body 的操作，这里会得到空数据或 EOF 错误。

路径参数（URL path）要用 chi、gorilla/mux 等路由库，标准库不支持

Go 标准 net/http 路由不解析路径参数，像 /user/:id 这种写法不会自动绑定到变量。必须用第三方路由器：

// chi 示例
r := chi.NewRouter()
r.Get("/user/{id}", func(w http.ResponseWriter, r *http.Request) {
    id := chi.URLParam(r, "id") // 得到字符串 "123"
})

如果坚持不用库，只能手动切分 r.URL.Path，但要处理好 URL 编码、边界匹配、可选段等细节，容易出错且不可维护。

今天带大家了解了的相关知识，希望对你有所帮助；关于Golang的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~