本文详解 go 中 `net/http` 请求体（body）为空的原因及解决方案，重点区分 get 查询参数与 post 请求体的处理方式，并提供完整示例代码。
在 Go 的 net/http 包中，http.Request.Body 仅包含请求原始报文体（body）的内容，例如 POST、PUT 等方法中通过 Content-Type: application/json 发送的 JSON 数据。而 GET 请求的查询参数（query string）并不在 Body 中——它们被编码在 URL 末尾（如 /step?steps=1&direction=1），因此调用 json.NewDecoder(req.Body).Decode(...) 在 GET 请求下必然失败：req.Body 为 nil 或已读尽，解码结果为 <nil>。
✅ 正确处理方式取决于请求方法
1. 对于 GET 请求（含 URL 查询参数）
应使用 req.ParseForm() 解析查询字符串，再通过 req.FormValue() 或 req.Form 获取值：
func stepHandler(res http.ResponseWriter, req *http.Request) {
// 必须先调用 ParseForm —— 它会同时解析 query string 和表单 body（若存在）
if err := req.ParseForm(); err != nil {
http.Error(res, "Invalid form data", http.StatusBadRequest)
return
}
steps := req.FormValue("steps") // string: "1"
direction := req.FormValue("direction") // string: "1"
cellsJSON := req.FormValue("cells") // string: "[{\"row\":11,...}]"
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() 是幂等的，但必须在首次访问 req.Form 或 req.PostForm 前调用；对 GET 请求，它主要解析 req.URL.Query()。
2. 对于 POST 请求（发送 JSON Body）
需确保前端发送的是真正的 JSON 请求体，并设置正确 Header：
前端（AJAX 修改版）：
$.ajax({
url: "/step",
method: "POST",
contentType: "application/json", // 关键：声明 Content-Type
data: JSON.stringify({
steps: parseInt($("#step-size").val()),
direction: $("#step-forward").prop("checked") ? 1 : -1,
cells: painted // 直接传数组，不再 stringify 外层
}),
success: function(data) {
painted = data;
redraw();
}
});后端（接收 JSON Body）：
func stepHandler(res http.ResponseWriter, req *http.Request) {
if req.Method != "POST" {
http.Error(res, "Method not allowed", http.StatusMethodNotAllowed)
return
}
var payload struct {
Steps int `json:"steps"`
Direction int `json:"direction"`
Cells []struct{ Row, Column int } `json:"cells"`
}
// Body 可被 json.Decoder 读取（注意：Body 只能读一次！）
if err := json.NewDecoder(req.Body).Decode(&payload); err != nil {
http.Error(res, "Invalid JSON in request body", http.StatusBadRequest)
return
}
log.Printf("Received: %+v", payload)
}? 关键总结
- req.Body ≠ 查询参数：GET 参数在 URL 中，不在 Body；
- req.ParseForm() 是解析查询参数和 x-www-form-urlencoded 表单的统一入口；
- json.Decoder 仅适用于 Content-Type: application/json 的请求体，且 Body 必须未被读取过；
- 混合使用时（如 GET + query + POST + JSON），需按 HTTP 规范明确语义，避免混淆；
- 调试技巧：打印 req.Method、req.URL.String()、req.Header.Get("Content-Type") 和 req.ContentLength 可快速定位问题。
遵循上述原则，即可准确、健壮地处理各类 HTTP 请求参数。
