如何使用Golang处理HTTP请求Body_Golang请求Body读取与解析_技术教程

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。

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 请求体。不复杂但容易忽略细节。