Go中自定义HTTP请求Header需在发送前通过req.Header.Set/Add/Del操作，避免修改Host等自动管理字段；常用方法是newRequest后设置，或用自定义RoundTripper全局注入；JSON请求须显式设Content-Type。
在 Go 中自定义 HTTP 请求 Header 非常直接，核心是通过 *http.Request 的 Header 字段（类型为 http.Header，本质是 map[string][]string）进行增、删、改操作。关键在于时机和方式：必须在请求发出前设置，且注意某些 Header（如 Host、Content-Length）由 Go 标准库自动管理，手动设置可能被忽略或引发错误。
使用 http.NewRequest 手动构造并设置 Header
这是最常用、最可控的方式。先创建请求对象，再通过 req.Header.Set() 或 .Add() 添加自定义字段。
- Set(key, value)：覆盖该 key 的所有已有值（只保留一个）
-
Add(key, value)：追加值，允许同一 key 多个值（如多个
Cookie） - Del(key)：删除指定 key 的全部值
示例：
req, err := http.NewRequest("GET", "https://api.example.com/data", nil)
if err != nil {
log.Fatal(err)
}
req.Header.Set("User-Agent", "MyApp/1.0")
req.Header.Add("Accept", "application/json")
req.Header.Add("X-Request-ID", uuid.New().String())
// 发送
client := &http.Client{}
resp, err := client.Do(req)
通过 http.Client.Transport 自定义全局请求头（适用于复用场景）
如果多个请求需统一添加某些 Header（如认证 token），可包装 RoundTripper，在每次请求前注入 Header。注意不要修改原始请求对象以外的状态。
立即学习“go语言免费学习笔记（深入）”；
- 实现一个自定义
RoundTripper，在RoundTrip方法中克隆请求并设置 Header - 避免直接修改传入的
*http.Request，应使用req.Clone(req.Context())安全复制
示例（添加固定 Authorization）：
type authTransport struct {
base http.RoundTripper
token string
}
func (t *authTransport) RoundTrip(req *http.Request) (*http.Response, error) {
req = req.Clone(req.Context())
req.Header.Set("Authorization", "Bearer "+t.token)
return t.base.RoundTrip(req)
}
// 使用
client := &http.Client{
Transport: &authTransport{
base: http.DefaultTransport,
token: "your-jwt-token",
},
}
注意标准库自动处理的 Header 及常见陷阱
Go 的 http.Transport 会在发送前自动设置或覆盖部分 Header，手动设置可能无效甚至出错：
-
Host：由 URL 解析得出，手动设会被忽略；如需强制指定，应改用req.Host字段（非 Header） -
Content-Length和Transfer-Encoding：由 body 内容自动计算，手动设置易导致请求失败 -
Connection、Date、User-Agent（默认有值）：可覆盖，但需明确意图 - Header key 会自动规范化（如
"content-type"→"Content-Type"），建议用规范形式写 key
发送 JSON 请求时正确设置 Content-Type 和 Body
常见需求是发 POST/PUT JSON，需同时处理 Header 和序列化 Body：
- Body 必须是
io.Reader，通常用bytes.NewReader(data)或strings.NewReader(jsonStr) -
Content-Type: application/json必须显式设置（标准库不会自动加） - 确保 JSON 数据已正确序列化，且无编码错误
示例：
data := map[string]string{"name": "Alice"}
jsonBytes, _ := json.Marshal(data)
req, _ := http.NewRequest("POST", "https://api.example.com/users", bytes.NewReader(jsonBytes))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer xxx")
resp, _ := http.DefaultClient.Do(req)
基本上就这些。Golang 的 HTTP Header 处理不复杂但容易忽略细节，重点记住：早设置、别碰自动字段、区分 Set/ Add、JSON 要配对 Content-Type —— 掌握这几点，95% 的自定义需求都能稳稳搞定。
