Go语言通过http.Header处理HTTP头,客户端使用req.Header.Set/Add设置请求头,服务端用r.Header.Get读取,注意大小写不敏感、多值处理及Host头的特殊性。

在Go语言中处理HTTP请求的Header,主要通过http.Header类型来实现,它本质上是一个映射,用于存储键值对形式的HTTP头信息。无论是客户端发起请求,还是服务端接收请求,都可以通过标准库net/http提供的方法灵活地读取、设置和修改Header。
设置请求Header(客户端)
在使用http.Client发送请求时,可以通过http.Request对象的Header字段来添加或修改请求头。
示例:
- 创建一个
http.Request对象,通常使用http.NewRequest() - 调用
req.Header.Set(key, value)设置单个头字段 - 如需添加多个相同键的值,使用
req.Header.Add(key, value)
代码示例:
立即学习“go语言免费学习笔记(深入)”;
req, err := http.NewRequest("GET", "https://api.example.com/data", nil)
if err != nil {
log.Fatal(err)
}
req.Header.Set("Authorization", "Bearer token123")
req.Header.Set("User-Agent", "MyApp/1.0")
req.Header.Add("Accept", "application/json")
req.Header.Add("Accept", "text/plain") // 多值
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
读取请求Header(服务端)
在HTTP服务端,通过http.Request的Header字段可以获取客户端传来的Header信息。
常用方法:
-
req.Header.Get("Key"):获取指定键的第一个值(不区分大小写) -
req.Header["Key"]:返回该键对应的所有值的切片 -
req.Header.Values("Key"):获取所有值(Go 1.14+)
示例:
http.HandleFunc("/info", func(w http.ResponseWriter, r *http.Request) {
auth := r.Header.Get("Authorization")
if auth == "" {
w.WriteHeader(http.StatusUnauthorized)
return
}
accepts := r.Header["Accept"]
for _, accept := range accepts {
fmt.Fprintf(w, "Accept: %s\n", accept)
}
})
常见注意事项
Go的Header类型对键名不区分大小写,内部会规范化为标准格式(如Content-Type),但建议统一使用规范写法。
- 使用
Set会覆盖已有值,Add则追加新值 - 某些Header(如
Host)由Go自动管理,直接设置req.Host更安全 - 发送请求前确保Header已设置完毕
- 服务端读取时注意空值判断,避免空指针
Header.Set、Header.Get和Header.Add这几个核心方法,就能应对大多数场景。










