首页 > Golang > Go教程

GolangHTTPHeader处理方法全解析

时间：2025-10-31 22:27:37 386浏览收藏

掌握Golang处理HTTP请求Header的技巧是构建高效Web服务的关键。本文汇总了Golang中处理HTTP Header的常用方法，包括服务端如何读取请求Header（如使用`req.Header.Get`忽略大小写获取值，或遍历`req.Header`），以及如何设置响应Header（使用`w.Header().Set`和`w.Header().Add`）。同时，也介绍了客户端如何通过`req.Header.Set`添加请求Header。需要注意Header名称大小写不敏感，且响应Header必须在`Write`之前设置。本文旨在帮助开发者在API服务构建和第三方接口调用中，灵活处理Header信息，避免常见问题，提升开发效率。

答案：Go中通过req.Header.Get读取请求头，w.Header().Set设置响应头，客户端用req.Header.Set添加头，注意大小写不敏感和设置时机。

如何在Golang中处理HTTP请求Header_Golang HTTP请求Header处理方法汇总

在Golang中处理HTTP请求的Header是构建Web服务和客户端时的常见需求。无论是读取客户端发送的Header，还是为响应或请求设置自定义Header，都需要正确使用标准库中的相关方法。以下是常用的处理方式汇总，适用于服务端接收请求和客户端发起请求两种场景。

读取HTTP请求Header（服务端）

在HTTP服务端，可以通过http.Request对象访问请求Header。Header以键值对形式存储，一个键可能对应多个值。

使用req.Header.Get("Key")获取某个Header的值（返回第一个值，忽略大小写）
使用req.Header["Key"]获取所有该Key对应的值（注意Key大小写敏感）
遍历所有Header可使用for range req.Header

示例：

func handler(w http.ResponseWriter, r *http.Request) { // 获取User-Agent userAgent := r.Header.Get("User-Agent") // 获取所有Accept-Language值 langs := r.Header["Accept-Language"] // 遍历所有Header for key, values := range r.Header { fmt.Printf("%s: %v\n", key, values) } }

设置HTTP响应Header（服务端）

服务端可通过http.ResponseWriter的Header()方法设置响应Header。注意必须在调用Write之前设置。

使用w.Header().Set("Key", "Value")设置单个值
使用w.Header().Add("Key", "Value")追加值（用于多值Header）

示例：

func handler(w http.ResponseWriter, r *http.Request) { w.Header().Set("Content-Type", "application/json") w.Header().Add("Set-Cookie", "session=abc123") w.Header().Add("Set-Cookie", "theme=dark") w.Write([]byte(`{"status": "ok"}`)) }

为HTTP客户端请求设置Header

当使用http.Client发起请求时，可以在构建http.Request后通过其Header字段设置Header。

使用req.Header.Set或req.Header.Add添加Header
也可在创建请求后直接操作Header映射

示例：

client := &http.Client{} req, _ := http.NewRequest("GET", "https://api.example.com/data", nil) // 设置Authorization req.Header.Set("Authorization", "Bearer token123") // 添加Accept头 req.Header.Add("Accept", "application/json") resp, err := client.Do(req) if err != nil { log.Fatal(err) } defer resp.Body.Close()

常见注意事项

处理Header时需注意以下几点，避免常见问题：

Header名称不区分大小写，但Go的map键是大小写敏感的，建议统一使用规范格式（如Content-Type）
某些Header如Host由Go自动设置，手动设置可能无效
响应Header必须在WriteHeader或Write调用前设置
使用Get方法更安全，它会自动处理大小写和空值情况

基本上就这些。掌握这些方法后，无论是构建API服务还是调用第三方接口，都能灵活处理Header信息。关键是理解Header的多值特性以及设置时机。不复杂但容易忽略细节。

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