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的)会拒绝请求。