在Golang中设置请求Header需用req.Header.Set或Add方法,且必须在http.DefaultClient.Do前完成;自定义Host头须设req.Host字段;Content-Type需在NewRequest后设置;不可手动设Content-Length或Transfer-Encoding。
直接赋值 req.Header 不生效,因为 http.NewRequest 创建的请求对象默认会冻结 Header(尤其是当 URL scheme 为 http 或 https 时),必须在调用 http.DefaultClient.Do 前完成设置,且需使用 req.Header.Set 或 req.Header.Add 方法。
req.Header.Set("User-Agent", "my-app/1.0"):覆盖已有同名 Header(推荐用于单值字段,如 User-Agent、Content-Type)req.Header.Add("Cookie", "sid=abc"):追加字段(适用于可重复 Header,如 Cookie、X-Forwarded-For)req.Header["User-Agent"] = []string{"..."} —— 这种直接赋 map 的方式会被底层忽略http.NewRequestWithContext 构建的,Header 设置时机不变,仍需在 Do 前完成Golang 的 net/http 默认禁止修改 Host 字段,这是出于安全考虑(防止 Host 头走私)。若需覆盖(例如对接本地 mock 服务或调试反向代理),必须显式设置 req.Host 字段,而非往 req.Header 里塞:
req, _ := http.NewRequest("GET", "http://example.com/api", nil)
req.Host = "mock.internal" // ✅ 正确:直接赋值 req.Host
// req.Header.Set("Host", "mock.internal") ❌ 无效
req.Host 后,HTTP/1.1 请求行中的 host 部分将使用该值http://localhost:8080),而 req.Host 未带端口,则可能触发连接失败;建议保持端口一致req.Host 还会影响 TLS SNI,务必与目标服务器预期一致设置 Content-Type 必须在构造 Body 之后、发送之前,否则某些情况下(如使用 strings.NewReader 后再 Set)会被 client 自动重写:
body := strings.NewReader(`{"name":"alice"}`)
req, _ := http.NewRequest("POST", "https://api.example.com/users", body)
req.Header.Set("Content-Type", "application/json; charset=utf-8") // ✅ 必须在这之后设
// req.Header.Set("Content-Type", ...) 放在 NewRequest 前 ❌ 可能被覆盖
json.Marshal + bytes.NewReader,同样要确保 Set("Content-Type") 在 http.NewRequest 调用之后http.Post 等快捷函数时无法控制 Header,必须用 http.NewRequest + http.DefaultClient.Do
*os.File 或其他流式类型,Content-Length 会自动计算,但 Content-Type 仍需手动指定Golang 的 http.Client 会在发送前自动注入若干标准 Header,例如:
Accept-Encoding: gzip(除非显式禁用:req.Header.Set("Accept-Encoding", ""))User-Agent: Go-http-client/1.1(除非显式覆盖)Content-Length 或 Transfer-Encoding(由 Body 类型自动决定,不可手动设,否则 panic)Connection: keep-alive(HTTP/1.1 默认行为,无法关闭)
req → 显式 Set 所有需要的字段 → 检查是否意外存在不期望的字段(如打印 req.Header)→ 再调用 Do。尤其注意 Content-Length 和 Transfer-Encoding 绝对不要手动设置,否则会触发 http: ContentLength=xxx with Body length 0 类错误。