GoHTTP参数解析全攻略

IT行业相对于一般传统行业，发展更新速度更快，一旦停止了学习，很快就会被行业所淘汰。所以我们需要踏踏实实的不断学习，精进自己的技术，尤其是初学者。今天golang学习网给大家整理了《Go HTTP 请求参数解析指南》，聊聊，我们一起来看看吧！

在 Go 的 net/http 中，`req.Body` 仅包含请求体（如 POST/PUT 的原始数据），而 URL 查询参数（GET 参数）始终位于 URL 中，需通过 `req.ParseForm()` 解析后从 `req.Form` 或 `req.URL.Query()` 获取，直接读取 `req.Body` 必然为空。

你遇到的 req.Body 始终为空、json.Decoder 解析失败并输出 ，根本原因在于：你的客户端使用的是 GET 请求，所有参数都作为查询字符串拼接在 URL 后（如 /step?steps=1&direction=1&cells=[...]），而 req.Body 在标准 GET 请求中默认为 nil 或空流——它不承载 URL 参数。

✅ 正确做法：区分请求类型，按需解析

1. 若坚持使用 GET（推荐用于简单参数）

URL 查询参数应通过 req.URL.Query() 或 req.FormValue() 获取，无需且不能用 json.Decoder 读 Body：

func stepHandler(res http.ResponseWriter, req *http.Request) {
    // ✅ 正确：解析 URL 查询参数
    if err := req.ParseForm(); err != nil {
        http.Error(res, "Invalid query", http.StatusBadRequest)
        return
    }

    steps := req.FormValue("steps")           // "1"
    direction := req.FormValue("direction")   // "1"
    cellsJSON := req.FormValue("cells")       // "[{\"row\":11,\"column\":15},...]"

    // 解析 JSON 字符串字段（如 cells）
    var cells []map[string]interface{}
    if err := json.Unmarshal([]byte(cellsJSON), &cells); err != nil {
        http.Error(res, "Invalid cells JSON", http.StatusBadRequest)
        return
    }

    log.Printf("Steps: %s, Direction: %s, Cells: %+v", steps, direction, cells)
}

? 提示：req.ParseForm() 是安全的幂等操作，对 GET/POST 均有效；对 GET 请求，它会自动解析 req.URL.RawQuery。

2. 若需传输结构化 JSON（更规范的做法）

应改用 POST 请求 + Content-Type: application/json，此时参数才真正存在于 req.Body 中：

✅ 客户端（AJAX）改为：

$.ajax({
  url: "/step",
  method: "POST",
  contentType: "application/json",
  data: JSON.stringify({
    steps: parseInt($("#step-size").val()),
    direction: $("#step-forward").prop("checked") ? 1 : -1,
    cells: painted // 直接传数组，无需额外 stringify
  }),
  success: function(data) { /* ... */ }
});

✅ 服务端（接收 JSON Body）：

func stepHandler(res http.ResponseWriter, req *http.Request) {
    if req.Method != "POST" {
        http.Error(res, "Method not allowed", http.StatusMethodNotAllowed)
        return
    }

    // ✅ 此时 req.Body 才有内容
    defer req.Body.Close()
    var payload struct {
        Steps     int          `json:"steps"`
        Direction int          `json:"direction"`
        Cells     []struct{ Row, Column int } `json:"cells"`
    }

    if err := json.NewDecoder(req.Body).Decode(&payload); err != nil {
        http.Error(res, "Invalid JSON", http.StatusBadRequest)
        return
    }

    log.Printf("Steps: %d, Direction: %d, Cells: %+v", 
        payload.Steps, payload.Direction, payload.Cells)
}

⚠️ 关键注意事项

• req.Body 不会自动包含查询参数，无论 GET 还是 POST —— 查询参数永远属于 URL，请求体只属于 POST/PUT/PATCH 等方法的 payload。
• req.ParseForm() 必须在首次访问 req.Form 或 req.PostForm 前调用（Go 1.19+ 已自动惰性调用，但仍建议显式调用以明确意图）。
• 对 req.Body 操作后（如 ioutil.ReadAll 或 json.Decoder.Decode），Body 流会被消耗完毕，不可重复读取；如需多次使用，请先 io.Copy(ioutil.Discard, req.Body) 并用 bytes.NewReader(buf) 重建。
• 使用 req.URL.Query() 可避免 ParseForm() 的副作用（如对 POST 表单的解析），更适合纯 GET 场景。

✅ 总结

选择合适的方式，才能让 Go 的 HTTP 处理既健壮又符合 REST 语义。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于Golang的相关知识，也可关注golang学习网公众号。