在Go语言开发中，使用标准库的net_http包发送HTTP请求时，设置合适的请求头是完成接口调用的基础操作，既可以满足服务端的鉴权要求，也能明确请求和响应的数据格式。
基础设置方法：使用Header字段
net_http包中，http.Request结构体提供了Header字段，类型是http.Header，本质是一个map[string][]string结构，我们可以通过这个字段直接设置请求头。
发送GET请求时设置请求头的示例代码如下：
package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
// 创建请求对象
req, err := http.NewRequest("GET", "http://ipipp.com/api/test", nil)
if err != nil {
fmt.Println("创建请求失败:", err)
return
}
// 设置单个请求头
req.Header.Set("User-Agent", "Go-HTTP-Client/1.0")
// 设置多个值的请求头
req.Header.Add("Accept", "application/json")
req.Header.Add("Accept", "text/plain")
// 直接赋值设置请求头（会覆盖已有值）
req.Header["Authorization"] = []string{"Bearer test_token_123"}
// 发送请求
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))
}
POST请求设置请求头
发送POST请求时设置请求头的逻辑和GET请求一致，只需要在创建请求时指定请求方法为POST，同时传入请求体即可。
发送JSON格式的POST请求示例：
package main
import (
"bytes"
"encoding/json"
"fmt"
"io/ioutil"
"net/http"
)
func main() {
// 构造请求体数据
data := map[string]string{
"username": "test_user",
"password": "test_pass",
}
jsonData, err := json.Marshal(data)
if err != nil {
fmt.Println("序列化数据失败:", err)
return
}
// 创建POST请求
req, err := http.NewRequest("POST", "http://ipipp.com/api/login", bytes.NewBuffer(jsonData))
if err != nil {
fmt.Println("创建请求失败:", err)
return
}
// 设置请求头，声明请求体格式为JSON
req.Header.Set("Content-Type", "application/json")
// 设置鉴权请求头
req.Header.Set("X-Request-Id", "req_20240501_001")
// 发送请求
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("响应状态码:", resp.StatusCode)
fmt.Println("响应内容:", string(body))
}
常用请求头设置说明
实际开发中常用的请求头设置方式可以参考下表：
| 请求头名称 | 设置方式 | 作用说明 |
|---|---|---|
| Content-Type | req.Header.Set("Content-Type", "application/json") | 声明请求体的数据格式 |
| Authorization | req.Header.Set("Authorization", "Bearer token") | 携带鉴权凭证，用于接口权限验证 |
| User-Agent | req.Header.Set("User-Agent", "自定义客户端标识") | 标识客户端类型，部分服务端会校验该字段 |
| Accept | req.Header.Add("Accept", "application/json") | 声明客户端可接受的响应数据格式 |
注意事项
- 设置请求头必须在调用
client.Do(req)之前完成，否则设置不会生效。 - 使用
Set方法设置请求头时，会覆盖该字段已有的所有值；如果需要添加多个值，应该使用Add方法。 - 请求头的键名不区分大小写，但是建议按照标准写法的首字母大写形式设置，比如
Content-Type而不是content-type。 - 如果请求需要携带Cookie，除了可以手动设置
Cookie请求头外，也可以使用req.AddCookie()方法添加，标准库会自动处理Cookie的格式。
注意：如果是使用http.Get()或者http.Post()这类快捷方法发送请求，无法直接设置自定义请求头，因为这些方法内部已经封装了请求创建的逻辑，需要自定义请求头时建议使用http.NewRequest创建请求对象。
快捷方法发送请求时的替代方案
如果一定要使用快捷方法，并且需要设置简单的请求头，可以通过修改默认请求头的方式实现，但是这种方式不够灵活，示例代码如下：
package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
// 使用默认客户端发送GET请求
resp, err := http.Get("http://ipipp.com/api/test")
if err != nil {
fmt.Println("发送请求失败:", err)
return
}
defer resp.Body.Close()
// 注意：这种方式只能在请求发送后读取响应头，无法修改请求头
fmt.Println("响应头中的Content-Type:", resp.Header.Get("Content-Type"))
}
综上，Go语言中设置HTTP请求头的核心是通过http.Request的Header字段操作，优先使用http.NewRequest创建请求对象后再设置请求头，能够满足绝大多数场景的需求。
Go语言HTTP请求头HTTP_Headernet_http修改时间：2026-07-04 22:24:26