在 Go 中设置 HTTP 请求头需先创建请求,再通过 req.Header.Set() 或 Add() 方法添加;标准头如 Host、Content-Length 应避免手动设置,Bearer Token 等认证信息可直接写入 Header。

在 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。例如:
立即学习“go语言免费学习笔记(深入)”;
-
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 值不要硬编码,建议从环境变量或配置中读取。










