Go中设置自定义Header必须在http.Request创建后、发送前操作,且Host等关键Header需通过req.Host等字段而非Header.Set设置。

Go中设置自定义Header必须在http.Request创建后、发送前操作
Go的http.Client本身不提供全局Header配置,所有自定义Header都必须作用于具体*http.Request对象。一旦调用client.Do(req),Header就冻结了——后续修改无效,也不会报错,但服务端收不到。
常见错误是误以为能像Python的requests.Session()那样预先设好Header:
req, _ := http.NewRequest("GET", "https://api.example.com", nil)
// ✅ 正确:立即设置
req.Header.Set("X-Api-Version", "v2")
req.Header.Set("Authorization", "Bearer abc123")
// ❌ 错误:Do之后再设——完全无效
client := &http.Client{}
resp, _ := client.Do(req)
req.Header.Set("X-Trace-ID", "deadbeef") // 这行不会发出去
Header.Set和Header.Add的区别直接影响服务端行为
Set会覆盖同名已有Header(包括Go自动加的User-Agent或Content-Length),Add则追加新值。多数场景应优先用Set,除非明确需要多值(如Accept)。
-
req.Header.Set("User-Agent", "myapp/1.0")→ 覆盖默认Go-http-client/1.1 -
req.Header.Add("Accept", "application/json")→ 可多次调用,最终Header为Accept: application/json, application/xml -
req.Header.Set("Content-Type", "application/json")→ 必须显式设置,POST/PUT时Go不会自动推断
POST请求中Body和Header的顺序依赖关系
如果用strings.NewReader或bytes.NewReader构造Body,Content-Length会被自动计算并写入Header;但如果Body是io.Reader(比如文件流),Go无法预知长度,此时必须手动设置Content-Length,否则部分服务端(尤其是严格遵循HTTP/1.1的)会拒绝请求。
body := strings.NewReader(`{"name":"alice"}`)
req, _ := http.NewRequest("POST", "https://api.example.com/users", body)
req.Header.Set("Content-Type", "application/json")
// ✅ Content-Length已由strings.NewReader支持,无需手动设
file, _ := os.Open("data.bin")
req2, _ := http.NewRequest("POST", "https://api.example.com/upload", file)
req2.Header.Set("Content-Type", "application/octet-stream")
// ❌ 错误:file是io.Reader,Content-Length为空
// ✅ 正确:需提前获取文件大小并设置
stat, _ := file.Stat()
req2.Header.Set("Content-Length", strconv.FormatInt(stat.Size(), 10))
避免被Go自动覆盖的关键Header
Go的http.Transport会对某些Header做静默处理:Host、Content-Length、Connection等。例如直接req.Header.Set("Host", "example.com")在多数情况下会被忽略,实际发送的仍是URL中的host。
若真需强制指定Host(比如测试虚拟主机或绕过CDN),必须改用req.Host字段:
req, _ := http.NewRequest("GET", "https://dummy.com/path", nil)
req.Host = "real.example.com" // ✅ 强制Host头
req.Header.Set("X-Forwarded-Host", "real.example.com") // ✅ 同时补业务Header
其他类似字段:req.URL.Scheme影响http/https,req.Close控制连接是否关闭——这些都不能靠Header模拟。
Content-Length的手动补全,以及误信Header.Set能改写Host。










