Golang解析HTTP头信息详解

本文深入解析了 Go 语言中 HTTP 头信息（http.Header）的核心机制与实战用法，涵盖请求头与响应头的获取、大小写不敏感访问、多值字段（如 Set-Cookie、Cookie）的特殊处理、Header 的安全修改时机（必须在 Write 前）、以及 Set/Add/Del 等关键操作的区别；同时揭示了 Header 底层 map[string][]string 结构的本质、自动标准化行为及调试遍历技巧，帮助开发者避开常见陷阱，写出更健壮、符合 HTTP 协议规范的 Go Web 代码。

在 Go 语言中，HTTP 请求和响应头（Header）都以 http.Header 类型存在，本质是 map[string][]string。解析 Header 的关键在于理解其结构、区分大小写不敏感的访问方式，并正确处理多值字段（如 Set-Cookie）。

获取请求 Header（服务端）

在 HTTP 处理函数中，*http.Request 的 Header 字段直接暴露所有请求头。Go 自动将原始 Header 名标准化为“首字母大写-连字符分隔”格式（如 User-Agent → User-Agent），但读取时忽略大小写。

• 用 r.Header.Get("User-Agent") 获取单个值（返回第一个，或空字符串）
• 用 r.Header["Accept-Encoding"] 获取原始 slice（可能为空或含多个值）
• 注意：Get 对 Cookie 特殊处理——它会合并所有 Cookie 头为一个字符串（用分号分隔），而 r.Cookies() 才返回解析后的 []*http.Cookie

获取响应 Header（客户端）

使用 http.DefaultClient.Do(req) 发起请求后，响应对象 *http.Response 的 Header 字段即为响应头。与请求头一样，支持 Get 和直接 map 访问。

• resp.Header.Get("Content-Type") 返回 "application/json; charset=utf-8" 这类值
• resp.Header["Set-Cookie"] 是 []string，每个元素对应一个 Set-Cookie 字段（浏览器需分别处理）
• 注意：resp.Header 不包含状态行信息（如 HTTP/1.1 200 OK），状态码通过 resp.StatusCode 单独获取

手动构造和修改 Header

无论是构建请求还是设置响应头，都通过 Header.Set、Header.Add、Header.Del 操作：

• req.Header.Set("Authorization", "Bearer abc123")：覆盖已有同名头
• req.Header.Add("Accept", "application/xml")：追加新值（允许重复键）
• w.Header().Set("Content-Type", "text/html; charset=utf-8")：在 HTTP handler 中设置响应头（w 是 http.ResponseWriter）
• 修改已发出的响应头无效——必须在调用 w.Write 或 w.WriteHeader 前完成

遍历和调试 Header

调试时可遍历全部 Header 键值对，注意键名已被标准化：

for key, values := range r.Header {
    fmt.Printf("%s: %v\n", key, values)
}

输出类似：
User-Agent: [curl/7.68.0]
Accept: [application/json]
若需原始未标准化键名（极少见），需在底层使用 net/http/httputil.DumpRequest 或自定义 net.Conn 拦截原始字节流。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Golang解析HTTP头信息详解》文章吧，也可关注golang学习网公众号了解相关技术文章。