HTTP请求参数与体解析详解

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

本文详解 Go 中 `net/http` 请求体为空的原因，指出 GET 请求的参数位于 URL 查询字符串而非请求体，并提供使用 `req.ParseForm()` 解析表单/查询参数、以及正确处理 JSON 请求体的完整方案。

在 Go 的 net/http 包中，req.Body 仅承载 HTTP 请求消息体（body）中的原始数据，例如 POST/PUT 请求中通过 Content-Type: application/json 发送的 JSON 内容。而你当前的 AJAX 请求使用的是 method: "get"，所有参数（steps、direction、cells）均被拼接在 URL 查询字符串中（如 /step?steps=1&direction=1&cells=...），根本不会写入请求体——因此 req.Body 为空（甚至可能为 nil），json.Decoder 自然无法解码，最终得到 。

✅ 正确做法取决于你的实际需求：

✅ 场景一：你本意就是读取 URL 查询参数（GET 请求）

无需操作 req.Body，应调用 req.ParseForm()，然后从 req.Form 或 req.URL.Query() 中提取值：

func stepHandler(res http.ResponseWriter, req *http.Request) {
    // 必须先调用 ParseForm（对 GET/POST 均有效）
    if err := req.ParseForm(); err != nil {
        http.Error(res, "Failed to parse form", http.StatusBadRequest)
        return
    }

    // 从查询参数中获取值（自动解码 URL 编码）
    steps := req.FormValue("steps")           // "1"
    direction := req.FormValue("direction")   // "1"
    cellsJSON := req.FormValue("cells")       // "[{\"row\":11,\"column\":15},...]"

    // 若 cells 是 JSON 字符串，需二次解析
    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.FormValue(key) 是安全便捷的方式，它会自动调用 ParseForm()（若未调用过），并返回首个匹配键的值（已 URL 解码）。对于 GET 请求，req.URL.Query() 效果相同，但 req.Form 更通用（兼容 POST 表单）。

✅ 场景二：你希望真正发送 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) {
    painted = data;
    redraw();
  }
});

后端（Go）：

func stepHandler(res http.ResponseWriter, req *http.Request) {
    // 确保是 POST 且 Content-Type 正确
    if req.Method != "POST" || req.Header.Get("Content-Type") != "application/json" {
        http.Error(res, "Method not allowed", http.StatusMethodNotAllowed)
        return
    }

    var payload struct {
        Steps     int           `json:"steps"`
        Direction int           `json:"direction"`
        Cells     []struct {
            Row    int `json:"row"`
            Column int `json:"column"`
        } `json:"cells"`
    }

    if err := json.NewDecoder(req.Body).Decode(&payload); err != nil {
        http.Error(res, "Invalid JSON", http.StatusBadRequest)
        return
    }
    defer req.Body.Close() // ⚠️ 切记关闭 Body！

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

⚠️ 关键注意事项

• req.Body 不可重复读取：一旦被 json.Decoder 或 ioutil.ReadAll 消费，再次读取将返回空。务必在需要时只读一次，并及时 Close()。
• req.ParseForm() 对 GET 请求解析 URL.Query()，对 POST 解析 application/x-www-form-urlencoded 或 multipart/form-data；它不解析 JSON 请求体。
• 混淆 query string（URL 参数）与 request body（消息体）是 Go 新手常见误区。牢记：GET 无 body，参数全在 URL；POST/PUT 的 body 才需 json.Decoder。

选择合适的方式，你的请求数据就能被准确、可靠地解析了。

本篇关于《HTTP请求参数与体解析详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！