应使用r.URL.Query()获取query参数,而非r.FormValue();POST请求中r.FormValue()需先调用r.ParseForm()才有效;JSON请求须手动json.Decode(r.Body);路径参数需借助chi等路由库解析。

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 编码、边界匹配、可选段等细节,容易出错且不可维护。










