如何在 Go 的 HTTP 处理函数中获取 POST 请求参数

聖光之護 2026-01-14 00:00:00 次阅读

本文介绍在 go web 开发中，使用 `net/http` 和 gorilla mux 时，如何正确获取 post 请求中的表单参数（如 `application/x-www-form-urlencoded` 或 multipart 表单），并强调调用 `r.parseform()` 的必要性及常见陷阱。

在 Go 中，GET 参数可通过 mux.Vars(r)（路径变量）或 r.URL.Query().Get("key")（查询字符串）轻松获取；但 POST 参数的访问需额外注意请求体解析流程。r.FormValue("key") 是最常用、最简洁的方式，但它内部依赖 r.ParseForm() 的执行——若未显式调用且请求体未被解析，首次调用 FormValue 会自动触发解析；但若此前已手动读取 r.Body（如 io.ReadAll(r.Body)），则会导致解析失败并返回空值。

✅ 正确示例（推荐显式解析，确保健壮性）：

func logonPost(w http.ResponseWriter, r *http.Request) {
    // 必须先解析表单（支持 x-www-form-urlencoded 和 multipart）
    if err := r.ParseForm(); err != nil {
        http.Error(w, "无法解析表单数据", http.StatusBadRequest)
        return
    }

    login := r.FormValue("login")
    password := r.FormValue("password")

    // 注意：r.PostForm 是解析后的 map[string][]string，等价于 r.Form
    // 若需多值（如复选框），可用 r.PostForm["hobbies"] 获取 []string

    // 处理业务逻辑...
    w.WriteHeader(http.StatusOK)
    w.Write([]byte("登录成功"))
}

⚠️ 注意事项：

r.FormValue() 自动处理 POST、PUT、PATCH 等方法的表单数据，也兼容 GET 查询参数（即合并 r.URL.Query() 与 r.PostForm），但通常仅用于 POST 场景；

对于 application/json 请求体，请勿使用 FormValue，而应通过 json.Decoder 解析：

var req struct{ Login, Password string }
if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
    http.Error(w, "JSON 解析失败", http.StatusBadRequest)
    return
}