应优先调用 r.ParseForm() 再用 r.FormValue("q") 获取 query 参数,避免 r.URL.Query().Get() 返回空字符串或忽略重复 key;上传文件时须显式调 r.ParseMultipartForm(32

Go HTTP 服务中读取 query 参数:别直接用 r.URL.Query().Get() 就完事
query 参数(如 /search?q=go&limit=10 中的 q 和 limit)最常用,但 r.URL.Query().Get() 只返回第一个值,且不校验是否为空。实际开发中常因忽略重复 key 或空字符串导致逻辑错误。
-
r.URL.Query().Get("q")对?q=&q=go返回空字符串,不是"go";想取全部要用r.URL.Query()["q"] - 推荐统一用
r.ParseForm()后查r.FormValue("q")(自动合并、去空格、只取首值),或r.Form["q"](原始多值切片) - 注意:
r.ParseForm()会自动解析GET和POST表单(含application/x-www-form-urlencoded),但对JSON请求无效
从 POST 表单和 multipart 表单读参数:先调 r.ParseMultipartForm() 再取
如果前端用 提交(含文件上传),必须显式调用 r.ParseMultipartForm(),否则 r.Form 为空,r.PostFormValue() 返回空。
- 不设内存限制会把整个表单加载进内存:
r.ParseMultipartForm(32 表示最多 32MB 存内存,超量部分写临时文件 -
r.PostFormValue("name")只取非文件字段,安全且自动 trim;r.FormValue("name")在未调ParseMultipartForm时可能失效 - 文件字段必须用
r.MultipartReader()或r.FormFile("avatar")获取,不能走Form字段
解析 JSON 请求体:别用 io.ReadAll 多次读 r.Body
HTTP 请求体只能读一次。r.Body 是 io.ReadCloser,一旦被 json.NewDecoder(r.Body).Decode() 消费,后续再读就是空。常见错误是先 decode 再想 log 原始 body。
- 正确做法:用
bytes.Buffer缓存一份副本:buf := new(bytes.Buffer) buf.ReadFrom(r.Body) r.Body = io.NopCloser(buf) // 恢复可重读 json.NewDecoder(buf).Decode(&data)
- 更轻量方案:直接 decode 到 struct,避免中间 byte slice —— 除非你真需要原始 JSON 字符串做审计或转发
- 务必检查
Content-Type: application/json,否则json.Decode可能静默失败(比如遇到 HTML 响应头)
路径参数(URL path segment):用 chi 或 gorilla/mux,原生 net/http 不支持
net/http 的 http.ServeMux 只支持通配符 /path/,不解析 /user/:id 这类命名参数。硬编码字符串切分易出错,也不处理 URL 解码。
立即学习“go语言免费学习笔记(深入)”;
- 用
chi.Router:r.Get("/user/{id}", func(w http.ResponseWriter, r *http.Request) { id := chi.URLParam(r, "id") // 自动解码,如 %20 → 空格 }) - 用
gorilla/mux:vars := mux.Vars(r)得到map[string]string - 自定义解析风险高:比如
/a/b/c中取第二段,但没考虑路径编码、空段、尾部斜杠等边界
page 放 path 里,也别把 user_id 放 query 里传敏感信息。










