Golang设置HTTP头方法全解析

本文深入讲解了在 Go 语言中设置 HTTP 请求头的实用方法与关键细节，涵盖如何通过 `http.NewRequest` 创建请求后使用 `Header.Set()` 和 `Header.Add()` 灵活添加、覆盖或追加请求头字段，强调对 User-Agent、API Key、Bearer Token 等常见认证头的安全写法，并特别提醒避免手动干预 Host、Content-Length 等由标准库自动管理的敏感头字段——这些错误操作可能导致请求失败或 panic；同时介绍了封装默认头客户端和从环境变量安全注入 Token 的生产级实践，助你写出更健壮、可维护的 Go HTTP 客户端代码。

在 Go 中发送 HTTP 请求时，可以通过 http.Request 的 Header 字段设置自定义请求头。核心步骤是：创建请求、修改 Header、发送请求。

使用 http.NewRequest 设置自定义 Header

最常用的方式是先用 http.NewRequest 构造请求对象，再通过 req.Header.Set() 添加或覆盖头字段：

• Set(key, value)：设置一个头，若已存在则覆盖
• Add(key, value)：追加一个头（允许同名多个值，如 Cookie）
• Get(key)：读取头的值（返回第一个匹配项）

示例：

req, err := http.NewRequest("GET", "https://httpbin.org/get", nil)
if err != nil {
    log.Fatal(err)
}
req.Header.Set("User-Agent", "MyApp/1.0")
req.Header.Set("X-API-Key", "abc123")
req.Header.Add("Accept", "application/json")
req.Header.Add("Accept", "text/plain") // 多个 Accept 值

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

注意标准头字段的特殊处理

某些头（如 Content-Length、Host、Connection）由 Go 标准库自动管理，手动设置可能被忽略或引发 panic。例如：

• Host：应通过 req.URL.Host 或 req.Host 设置，而非 Header.Set("Host", ...)
• Content-Length：通常由 http.Client 自动计算；若手动设置错误，可能导致请求失败
• Authorization：可安全使用 Set，但建议用 req.SetBasicAuth() 或手动拼接更清晰

使用 http.Client 默认头（适用于多个请求）

如果多个请求需共用相同头，可封装一个带默认头的客户端：

client := &http.Client{}
// 创建带默认头的请求函数
newRequest := func(method, urlStr string, body io.Reader) (*http.Request, error) {
    req, err := http.NewRequest(method, urlStr, body)
    if err != nil {
        return nil, err
    }
    req.Header.Set("User-Agent", "Go-Client/1.0")
    req.Header.Set("Content-Type", "application/json")
    return req, nil
}

req, _ := newRequest("POST", "https://httpbin.org/post", strings.NewReader(`{"name":"alice"}`))
resp, _ := client.Do(req)

发送带认证或 Token 的请求

常见场景如 Bearer Token 或 API Key，直接写入 Header 即可：

• Bearer Token：req.Header.Set("Authorization", "Bearer xxxxx")
• API Key：req.Header.Set("X-Api-Key", "key-12345")
• Basic Auth：req.SetBasicAuth("user", "pass")（自动编码并设置 Authorization）

注意 Token 值不要硬编码，建议从环境变量或配置中读取。

今天带大家了解了的相关知识，希望对你有所帮助；关于Golang的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~