如何正确解析 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）改为：

神卷标书

神卷标书，专注于AI智能标书制作、管理与咨询服务，提供高效、专业的招投标解决方案。支持一站式标书生成、模板下载，助力企业轻松投标，提升中标率。

下载

$.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 语义。