Go语言通过net/http包读取Header和Body,Header用r.Header.Get获取值,Body需用ioutil.ReadAll或json.NewDecoder解析,注意Body只能读一次且需关闭,结合Header判断内容类型并选择解析方式,中间件可缓存Body实现重用,确保资源释放与请求正确处理。

在Go语言中处理HTTP请求时,正确读取和解析Header与Body是构建Web服务的基础。无论是开发API接口还是中间件,都需要准确获取客户端发送的元信息和数据内容。Golang标准库net/http提供了清晰且高效的机制来操作这些部分。
读取HTTP请求Header
HTTP Header包含客户端传递的元数据,如认证信息、内容类型、用户代理等。在Go的http.Request对象中,Header以键值对形式存储,可通过Header字段访问。
说明:Header字段实际是一个
map[string][]string,同一个键可能对应多个值(例如多个Set-Cookie)。虽然多数情况下使用首值即可,但需注意多值场景。常用操作包括:
立即学习“go语言免费学习笔记(深入)”;
- 使用
r.Header.Get("Key")获取某个Header的值(返回第一个值或空字符串)- 使用
r.Header["Key"]获取所有同名Header的值切片- 区分大小写问题:Header键不区分大小写,建议使用规范格式如
示例:检查请求是否为JSON类型Content-Typeif contentType := r.Header.Get("Content-Type"); contentType != "application/json" { http.Error(w, "unsupported content type", http.StatusUnsupportedMediaType) return }读取HTTP请求Body
请求体(Body)通常携带客户端提交的实际数据,比如表单、JSON或文件。Go中通过
r.Body字段读取,其类型为io.ReadCloser,使用后必须关闭以避免资源泄漏。关键点:Body只能读取一次,后续读取将返回EOF。若需多次读取(如中间件验证后再交由处理器),应缓存内容。
常见读取方式:
- 使用
ioutil.ReadAll(r.Body)一次性读取全部内容(适用于小数据) - 使用
json.NewDecoder(r.Body).Decode(&data)直接解码JSON数据到结构体 - 对于大文件上传,可配合
io.Copy流式处理,避免内存溢出
var reqData struct { Name string `json:"name"` } if err := json.NewDecoder(r.Body).Decode(&reqData); err != nil { http.Error(w, "invalid JSON", http.StatusBadRequest) return } defer r.Body.Close()结合Header与Body的实用技巧
在实际开发中,Header和Body往往需要协同处理。例如根据Content-Type选择不同的解析策略,或验证签名后再读取内容。
典型做法包括:
- 先读取必要的Header(如Authorization、Content-Length),再决定是否读取Body
- 在中间件中统一处理日志、鉴权或限流,避免每个Handler重复逻辑
- 对Body进行预读并替换
r.Body为bytes.NewReader(cache),实现重用
httputil.DumpRequest可快速调试完整请求内容基本上就这些。掌握Header与Body的处理方式,能让Go Web服务更稳健高效。关键是理解只读性和资源管理,避免常见陷阱。
- 使用










