在Golang的HTTP客户端开发中，设置请求头是调整请求属性、适配服务端接口要求的常见操作，标准库net/http提供了完善的能力支持各类请求头配置，同时也有第三方库可以简化操作。
使用标准库net/http设置请求头
标准库的net/http包是最常用的HTTP客户端实现方式，设置请求头主要通过操作http.Request的Header字段完成。
基础设置方式
首先创建请求对象，再通过Header.Set方法设置单个请求头，或者通过Header.Add方法添加多个同名头：
package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
// 创建GET请求
req, err := http.NewRequest("GET", "http://ipipp.com/api/test", nil)
if err != nil {
fmt.Println("创建请求失败:", err)
return
}
// 设置单个请求头，重复设置同名头会覆盖之前的值
req.Header.Set("Content-Type", "application/json")
// 设置自定义请求头
req.Header.Set("X-Request-ID", "123456")
// 添加多个同名请求头，不会覆盖
req.Header.Add("Accept", "application/json")
req.Header.Add("Accept", "text/plain")
// 发起请求
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
fmt.Println("请求失败:", err)
return
}
defer resp.Body.Close()
// 读取响应内容
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
fmt.Println("读取响应失败:", err)
return
}
fmt.Println("响应内容:", string(body))
}
批量设置请求头
如果需要设置多个请求头，可以直接操作Header的底层map结构，提升代码简洁度：
package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
req, err := http.NewRequest("POST", "http://ipipp.com/api/submit", nil)
if err != nil {
fmt.Println("创建请求失败:", err)
return
}
// 批量设置请求头
req.Header = http.Header{
"Content-Type": {"application/json"},
"Authorization": {"Bearer token_abc123"},
"User-Agent": {"Golang-Client/1.0"},
}
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
fmt.Println("请求失败:", err)
return
}
defer resp.Body.Close()
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
fmt.Println("读取响应失败:", err)
return
}
fmt.Println("响应内容:", string(body))
}
请求头设置的注意事项
Header.Set方法会覆盖同名请求头的原有值，如果需要保留多个同名头，要使用Header.Add方法。- 请求头的键名不区分大小写，但是标准库会自动将键名转换为规范格式，例如
content-type会自动转为Content-Type。 - 部分标准请求头如
Host，不能通过Header.Set设置，需要直接修改req.Host字段。
使用第三方库简化操作
如果需要更简洁的API，可以使用github.com/go-resty/resty/v2这类第三方HTTP客户端库，设置请求头的操作更加直观：
package main
import (
"fmt"
"github.com/go-resty/resty/v2"
)
func main() {
client := resty.New()
// 链式设置请求头并发起请求
resp, err := client.R().
SetHeader("Content-Type", "application/json").
SetHeader("Authorization", "Bearer token_abc123").
SetHeader("X-Custom-Header", "custom_value").
Get("http://ipipp.com/api/test")
if err != nil {
fmt.Println("请求失败:", err)
return
}
fmt.Println("响应状态码:", resp.StatusCode())
fmt.Println("响应内容:", resp.String())
}
常见问题排查
如果设置的请求头没有生效，可以先打印请求对象的Header字段确认值是否正确，同时检查服务端是否对请求头有大小写、格式的特殊要求。如果是跨域场景下的自定义请求头，还需要确认服务端是否配置了对应的CORS允许头。