Golang Web服务如何读取请求参数_HTTP参数解析方法

应优先调用 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 解码。

• 用 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 中取第二段，但没考虑路径编码、空段、尾部斜杠等边界

路径参数和 query 参数容易混用，但语义不同：ID 类固定资源标识放 path，筛选/分页类可选条件放 query。别把 page 放 path 里，也别把 user_id 放 query 里传敏感信息。