本文详解 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。
选择合适的方式，你的请求数据就能被准确、可靠地解析了。
