Go中读取HTTP请求体需用io.ReadAll一次性读取并调用Close()防泄漏；JSON解析推荐json.NewDecoder；表单用ParseForm，文件上传用ParseMultipartForm并设内存限制。
在使用 Golang 处理 HTTP 请求时，读取和解析请求体（Body）是常见需求，尤其是在构建 RESTful API 时。正确处理 Body 能确保程序稳定接收客户端传来的数据。下面介绍如何在 Go 中高效读取和解析 HTTP 请求的 Body。
读取原始 Body 数据
HTTP 请求的 Body 是一个 io.ReadCloser 类型，可以通过 io.ReadAll 一次性读取全部内容。注意：Body 只能被读取一次，重复读取会返回空值。
- 使用 io.ReadAll(r.Body) 获取原始字节流
- 读取后记得调用 r.Body.Close() 防止内存泄漏
- 建议将读取结果缓存，避免多次读取失败
示例代码：
body, err := io.ReadAll(r.Body)
if err != nil {
http.Error(w, "读取请求体失败", http.StatusBadRequest)
return
}
defer r.Body.Close()
fmt.Printf("接收到的数据: %s\n", body)
解析 JSON 格式的 Body
大多数现代 Web 服务使用 JSON 传递数据。Go 的 encoding/json 包提供了 json.NewDecoder 和 json.Unmarshal 两种方式解析 JSON Body。
立即学习“go语言免费学习笔记（深入）”；
- json.NewDecoder(r.Body).Decode(&target) 更高效，适合直接从 Body 解码
- json.Unmarshal(body, &target) 适合已读取的字节切片
- 结构体字段需导出（首字母大写），并建议添加 json tag
示例：
type User struct {
Name string `json:"name"`
Age int `json:"age"`
}
var user User
if err := json.NewDecoder(r.Body).Decode(&user); err != nil {
http.Error(w, "JSON 解析失败", http.StatusBadRequest)
return
}
fmt.Printf("用户: %+v\n", user)
处理表单和文件上传
对于 application/x-www-form-urlencoded 或 multipart/form-data 类型的请求，可以使用 r.ParseForm() 和 r.ParseMultipartForm()。
- 调用 r.ParseForm() 后可通过 r.FormValue("key") 获取字段
- 文件上传需使用 r.FormFile("file") 获取文件句柄
- multipart 请求需设置最大内存限制（如 32MB）
示例：
if err := r.ParseMultipartForm(32 << 20); err != nil {
http.Error(w, "表单解析失败", http.StatusBadRequest)
return
}
// 读取文本字段
name := r.FormValue("name")
// 读取文件
file, handler, err := r.FormFile("avatar")
if err != nil {
http.Error(w, "获取文件失败", http.StatusBadRequest)
return
}
defer file.Close()
注意事项与最佳实践
处理 Body 时有几个关键点容易忽略：
- Body 读取后即关闭，不要在中间件中部分读取而不恢复
- 对未知大小的 Body 设置读取超时或限制大小，防止 OOM
- 使用 http.MaxBytesReader 限制上传体积
- 始终校验解析后的数据是否合法
例如限制请求体不超过 8MB：
r.Body = http.MaxBytesReader(w, r.Body, 8<<20)
body, err := io.ReadAll(r.Body)
if err != nil {
if err.Error() == "http: request body too large" {
http.Error(w, "请求体过大", http.StatusRequestEntityTooLarge)
return
}
}
基本上就这些。掌握不同格式的读取方式，并注意资源管理和安全性，就能在 Go 中稳妥处理各种 HTTP 请求体。不复杂但容易忽略细节。
