Go语言如何设置HTTP请求头_HTTP Header设置方法

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而不报具体原因。