正确操作HTTP Header可提升Go Web服务的安全性与兼容性。1. 读取请求Header时推荐使用r.Header.Get("Content-Type"),不区分大小写且返回首个值;2. 设置响应Header用w.Header().Set()覆盖或Add()追加,适用于多值头如Set-Cookie;3. 中间件中统一设置安全头,如X-Frame-Options和Strict-Transport-Security;4. 客户端通过http.NewRequest创建请求后,调用req.Header.Set()添加自定义头。合理使用这些方法能使Go的HTTP处理更规范、安全、易维护。

在Go语言中处理HTTP请求的Header是构建Web服务和客户端时的常见需求。正确地读取、设置和验证Header,不仅能提升程序的健壮性,还能增强安全性与兼容性。下面介绍一些实用的Golang HTTP Header操作技巧。
读取请求Header
在HTTP服务器端,可以通过http.Request对象访问请求头信息。Header字段是一个map[string][]string类型,支持多个同名Header。
常用方法如下:
- r.Header.Get("Content-Type"):获取指定Header的值(返回第一个值,忽略大小写)
- r.Header["Authorization"]:直接访问所有Authorization头,返回字符串切片
- r.Header.Values("X-Forwarded-For"):获取某个Header的所有值(需手动遍历)
注意:Get方法更安全,推荐用于大多数场景,因为它对键名不区分大小写,而直接索引是区分的。
立即学习“go语言免费学习笔记(深入)”;
设置响应Header
在返回响应前,使用http.ResponseWriter的Header()方法可以设置响应头。
示例:
w.Header().Set("Content-Type", "application/json")
w.Header().Set("X-Content-Type-Options", "nosniff")
w.Header().Add("Set-Cookie", "session=abc123; Path=/")
w.Header().Add("Set-Cookie", "theme=dark; Path=/")
Set会覆盖已存在的同名Header,Add则追加新值,适用于支持多值的Header如Set-Cookie。
中间件中统一处理Header
利用中间件可以在请求处理前或后集中管理Header,比如添加安全头、日志记录或身份验证。
简单示例:
func secureHeaders(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
w.Header().Set("X-Frame-Options", "DENY")
w.Header().Set("X-Content-Type-Options", "nosniff")
w.Header().Set("Strict-Transport-Security", "max-age=31536000; includeSubDomains")
next.ServeHTTP(w, r)
})
}
注册中间件后,所有经过的请求都会自动带上这些安全Header。
客户端发送自定义Header
使用http.Client发起请求时,可提前设置Header。
示例:
req, _ := http.NewRequest("GET", "https://api.example.com/data", nil)
req.Header.Set("Authorization", "Bearer token123")
req.Header.Set("User-Agent", "my-app/1.0")
client := &http.Client{}
resp, err := client.Do(req)
注意:必须使用NewRequest创建请求对象,才能自由修改Header。
基本上就这些。掌握Header的基本读写、合理使用Set/Add方法、结合中间件统一管理,能让你的Golang HTTP服务更规范、安全且易于维护。










