Golang HTTP请求Header自定义与解析实践-Golang-PHP中文网

Golang HTTP请求Header自定义与解析实践

P粉602998670

发布： 2025-09-23 12:56:01

原创

485人浏览过

在Go中可通过http.Request的Header字段设置自定义请求头，如使用req.Header.Set()添加X-Request-ID、Authorization等；也可预先构建http.Header对象并赋值以复用。发送请求后，通过resp.Header.Get()获取响应头单值，或遍历resp.Header读取所有头信息，并推荐使用X-前缀命名自定义头，结合HTTPS保护敏感数据。

golang http请求header自定义与解析实践

在Go语言中处理HTTP请求时，自定义Header和正确解析响应Header是常见需求，尤其在与API服务交互、身份认证、调试等场景中尤为重要。本文将通过实际代码示例，介绍如何在Golang中设置自定义请求头以及如何解析服务器返回的响应头信息。

自定义HTTP请求Header

在发起HTTP请求时，可以通过*http.Request对象的Header字段来添加自定义Header。这种方式适用于需要精确控制请求头内容的场景。

以下是一个使用http.NewRequest创建GET请求并设置自定义Header的例子：

client := &http.Client{}
req, err := http.NewRequest("GET", "https://httpbin.org/headers", nil)
if err != nil {
    log.Fatal(err)
}

// 设置自定义Header
req.Header.Set("X-Request-ID", "12345")
req.Header.Set("User-Agent", "MyApp/1.0")
req.Header.Set("Authorization", "Bearer token123")

resp, err := client.Do(req)
if err != nil {
    log.Fatal(err)
}
defer resp.Body.Close()

登录后复制

说明：Header.Set(key, value)用于设置单个Header值；若要添加多个同名Header，可使用Header.Add()方法。

立即学习“go语言免费学习笔记（深入）”；

使用http.Header简化初始化

你也可以在创建请求前预先构造http.Header对象，便于复用或批量设置：

Devv

Devv是一个专为程序员打造的新一代AI搜索引擎

140

查看详情

headers := http.Header{}
headers.Set("Content-Type", "application/json")
headers.Set("X-Custom-Trace", "trace-9876")

req, _ := http.NewRequest("GET", "https://api.example.com/data", nil)
req.Header = headers // 直接赋值

登录后复制

这种方式适合封装通用请求头，如微服务间调用的追踪头、版本标识等。

解析HTTP响应Header

服务器返回的响应头通常包含重要元数据，例如认证令牌、分页信息、缓存策略等。通过*http.Response的Header字段可以轻松读取这些信息。

示例如下：

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

// 获取特定Header
contentType := resp.Header.Get("Content-Type")
server := resp.Header.Get("Server")
authToken := resp.Header.Get("X-Auth-Token")

fmt.Println("Content-Type:", contentType)
fmt.Println("Server:", server)
</font>

登录后复制

注意：Header.Get()返回第一个匹配值（HTTP允许同一Header出现多次），若需获取所有值，应使用resp.Header["Key"]访问原始切片。