使用http.Header可自定义请求头,通过req.Header.Set设置User-Agent、Authorization等字段,再用http.Client发送请求。

在Go语言中发送HTTP请求并自定义请求头,是开发网络应用时的常见需求。无论是添加认证信息、指定内容类型,还是模拟特定客户端行为,都需要对请求头进行控制。Golang标准库net/http提供了灵活的方式实现这一点。下面介绍几种实用方法。
使用 http.Header 设置自定义请求头
创建一个http.Request对象后,可以通过其Header字段(类型为http.Header)来设置自定义头信息。这个字段本质上是一个映射,键为头名称,值为字符串切片。
示例代码:
package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://httpbin.org/headers", nil)
if err != nil {
panic(err)
}
// 自定义请求头
req.Header.Set("User-Agent", "MyApp/1.0")
req.Header.Set("Authorization", "Bearer token123")
req.Header.Set("X-Request-ID", "555")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
这里使用http.NewRequest构造请求,然后通过go语言免费学习笔记(深入)”;
在 Get 或 Post 请求中添加头信息
如果使用http.Get或http.Post这类便捷函数,无法直接传入头信息。必须先用NewRequest创建请求,再调用Client.Do发送。
例如发送带JSON头的POST请求:
req, err := http.NewRequest("POST", "https://httpbin.org/post", strings.NewReader(`{"name":"golang"}`))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Accept", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
注意:不能跳过NewRequest直接给Get/Post加头,否则会丢失自定义配置。
复用客户端与默认头设置
若多个请求需携带相同头(如鉴权Token),可封装一个带默认头的客户端或请求构造函数。
一种做法是创建辅助函数:
func newRequestWithHeaders(method, url string, body io.Reader) (*http.Request, error) {
req, err := http.NewRequest(method, url, body)
if err != nil {
return nil, err
}
req.Header.Set("Authorization", "Bearer my-secret-token")
req.Header.Set("User-Agent", "Custom-Client/1.0")
return req, nil
}
这样每次发起请求前调用该函数,就能自动带上固定头信息,减少重复代码。
注意事项与常见问题
设置请求头时有几个细节需要注意:
- 头名不区分大小写,但Go通常使用规范格式(如Content-Type)
- 使用Set会覆盖已有值,Add则追加新值(适用于多值头)
- 某些头(如Host)由客户端自动设置,手动修改需谨慎
- 确保Content-Type与实际发送数据格式一致,避免服务端解析错误
基本上就这些。掌握http.Request.Header的使用,就能灵活控制所有HTTP请求头行为。实际项目中建议封装通用请求逻辑,提升代码可维护性。










