Go中设置HTTP请求头必须用Header.Set/Add/Del方法，禁用直接赋值；Host、Content-Length等由系统自动管理，手动设置可能无效或出错；Content-Type须与body编码严格匹配；每次请求需独立设置Header，不可复用req对象。
Go中用http.Request.Header.Set设置请求头最常用
Go标准库的http.NewRequest返回的*http.Request对象，其Header字段是http.Header类型（本质是map[string][]string），所有请求头都通过它设置。直接赋值会panic，必须用Set、Add或Del方法操作。
常见错误是写成req.Header["User-Agent"] = []string{"my-app/1.0"}——这会导致运行时panic，因为底层map未初始化且禁止直接写入。
-
Set(key, value)：覆盖已有同名头（如多次调用Set("Accept", "json")，最终只保留最后一次） -
Add(key, value)：追加值（适用于允许重复的头，如Cookie） -
Del(key)：删除指定头
req, err := http.NewRequest("GET", "https://api.example.com", nil)
if err != nil {
log.Fatal(err)
}
req.Header.Set("User-Agent", "my-app/1.0")
req.Header.Set("Accept", "application/json")
req.Header.Add("Cookie", "sessionid=abc123")
req.Header.Add("Cookie", "theme=dark")
哪些HTTP头Go会自动设置或禁止手动覆盖
Go的http.Transport在发送请求前会自动添加或修正部分标准头，比如Host、Content-Length、Connection等。如果手动设置这些头，可能被忽略或触发校验失败。
特别注意：Host头由req.URL.Host决定，手动Set("Host", ...)无效；Content-Length由body长度自动计算，手动设错会引发http: invalid Content-Length错误；Transfer-Encoding和Connection也受限制。
立即学习“go语言免费学习笔记（深入）”；
- 可安全设置：
User-Agent、Authorization、Accept、Content-Type（POST/PUT时）、X-*自定义头 - 设了也无效：
Host（以URL为准）、Content-Length（除非明确禁用自动计算） - 设了可能出错：
Transfer-Encoding、Upgrade、Te（涉及底层连接控制）
POST请求中Content-Type和body编码要匹配
设置Content-Type只是声明“我发的是什么”，但实际body内容必须与之对应，否则服务端解析失败。常见组合有：
-
application/json→ body用json.Marshal序列化，再用bytes.NewReader包装 -
application/x-www-form-urlencoded→ body用url.Values.Encode()生成字符串 -
multipart/form-data→ 必须用mime/multipart包构造，不能手拼
data := map[string]string{"name": "Alice", "age": "30"}
jsonBytes, _ := json.Marshal(data)
req, _ := http.NewRequest("POST", "https://api.example.com/users", bytes.NewReader(jsonBytes))
req.Header.Set("Content-Type", "application/json") // 必须匹配实际body格式
使用http.Client复用连接时头设置的生命周期
每个*http.Request对象的Header是独立的，http.Client本身不保存头信息。所以不能“给client设个默认User-Agent”，而要在每次创建req时设置。若需统一管理，建议封装请求构造函数或使用中间件风格的包装器。
容易忽略的一点：如果复用*http.Request对象（比如修改URL后重发），它的Header仍保留上次的值，可能造成脏数据。务必确认是否需要清空或重置。
- 不要复用
req对象跨多次Do()调用（除非你清楚自己在做什么） - 避免在goroutine间共享未加锁的
req.Header - 若需全局默认头，写一个
newRequest()辅助函数，内部统一Set
Header设置看着简单，但和body编码、自动头机制、请求复用耦合紧密，错一处就可能返回400或500而不报具体原因。
