在Go中处理HTTP请求需掌握Header和Body操作：使用req.Header.Set设置请求头，如Content-Type和Authorization；通过json.Marshal、url.Values.Encode等构造不同格式的Body；服务端用json.NewDecoder解析请求体，注意Body只能读取一次并及时关闭；常见实践包括正确设置头部字段、避免手动设置Content-Length、统一使用标准Header命名，并在Client中配置超时防止请求挂起。
在Go语言中处理HTTP网络请求时，Header和Body是两个核心组成部分。正确操作它们对于构建可靠的客户端或服务端程序至关重要。本文将从实际应用出发，讲解如何在Golang中设置、读取、解析请求头（Header）和请求体（Body），并提供常见场景下的最佳实践。
设置与读取HTTP请求Header
在发起HTTP请求时，经常需要自定义请求头，比如添加认证Token、指定内容类型或伪装User-Agent。
使用http.Header可以灵活操作请求头：
- 通过req.Header.Set(key, value)设置单个头字段
- 使用req.Header.Add(key, value)追加多个相同键的值
- 读取响应头时直接访问resp.Header.Get(key)
示例：为POST请求添加JSON内容类型和授权头
立即学习“go语言免费学习笔记（深入）”；
client := &http.Client{}
req, _ := http.NewRequest("POST", "https://api.example.com/data", nil)
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer your-token-here")
resp, err := client.Do(req)
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
发送不同类型的请求Body
请求体（Body）承载了传输的主要数据。Golang支持多种格式的数据发送，关键在于正确构造io.Reader并设置对应Header。
常见类型包括：
- JSON数据：用json.Marshal序列化结构体，并设置Content-Type: application/json
- 表单数据：使用url.Values.Encode()生成，Content-Type设为application/x-www-form-urlencoded
- 原始字节或字符串：直接用strings.NewReader或bytes.NewBuffer
示例：发送JSON对象
data := map[string]interface{}{
"name": "Alice",
"age": 30,
}
body, _ := json.Marshal(data)
req, _ := http.NewRequest("POST", url, bytes.NewBuffer(body))
req.Header.Set("Content-Type", "application/json")
接收并解析请求Body（服务端视角）
在编写HTTP服务时，需从客户端请求中读取Body内容。注意Body只能读取一次，后续读取将返回EOF。
推荐做法：
- 使用ioutil.ReadAll(r.Body)或io.ReadAll完整读取
- 立即关闭r.Body避免资源泄露
- 对JSON请求体，用json.NewDecoder(r.Body).Decode(&target)直接解码
示例：解析JSON请求体
func handler(w http.ResponseWriter, r *http.Request) {
var input struct {
Name string `json:"name"`
Age int `json:"age"`
}
if err := json.NewDecoder(r.Body).Decode(&input); err != nil {
http.Error(w, "Invalid JSON", http.StatusBadRequest)
return
}
defer r.Body.Close()
fmt.Fprintf(w, "Hello %s, age %d", input.Name, input.Age)}
常见问题与注意事项
实际开发中容易忽略以下细节：
- Content-Length通常由Client自动计算，手动设置可能出错
- Body为空时应传nil或http.NoBody，避免空字符串导致意外长度
- Header大小写不敏感，但建议统一使用标准驼峰格式如Content-Type
- 超时控制应在Client层面设置，防止请求挂起
启用超时示例：
client := &http.Client{
Timeout: 10 * time.Second,
}
基本上就这些。掌握Header与Body的操作，能让你更自如地处理各类API交互场景。关键是理解Request和Response的结构，合理利用标准库提供的工具。不复杂但容易忽略细节，多练习就能熟练。
