必须用http.NewRequest+http.DefaultClient.Do设置Header,不能用http.Post;需先创建请求、再req.Header.Set()设头(如Authorization、Content-Type)、最后Do发送,且Header必须在Do前设置,重复Set会覆盖,Add可追加同名头。

用 http.NewRequest 构造带 Header 的请求对象
直接调用 http.Post 无法设置自定义 Header,必须走 http.NewRequest + http.DefaultClient.Do 路径。关键在于:先创建请求,再手动设置 Header,最后发送。
-
http.NewRequest第三个参数是io.Reader,传strings.NewReader(jsonStr)或bytes.NewBuffer(jsonBytes)都可以,但别传nil(否则 POST 变成无 body 的怪异行为) - Header 必须在调用
Do前设置,req.Header.Set("Authorization", "Bearer xxx")是最常用写法;重复 Set 会覆盖,要用Add才能追加同名 Header - 如果发 JSON,记得同时设
req.Header.Set("Content-Type", "application/json"),否则后端可能解析失败
注意 Content-Length 是否被自动处理
Go 的 http.Client 默认会在发送前自动计算并设置 Content-Length,前提是 body 是 *bytes.Buffer、*strings.Reader 或实现了 Len() 方法的类型。但如果用 bytes.NewReader(data),它没有 Len(),Client 就会改用 chunked 编码——某些老旧 API(比如部分金融或政企系统)不支持 chunked,会直接 411 或 400。
- 安全做法:用
bytes.NewBuffer(data)替代bytes.NewReader(data) - 或者显式调用
req.ContentLength = int64(len(data)),再设req.Header.Set("Content-Length", strconv.FormatInt(req.ContentLength, 10)) - 调试时用
curl -v对比请求头,确认是否出现Transfer-Encoding: chunked
常见错误:Header 被 silently 忽略
Go 对某些 Header 名做了白名单限制,比如 "Connection"、"Host"、"Content-Length" 等,直接 Set 不会报错,但实际不会发出去——这是标准库的静默行为,极易踩坑。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
- 检查是否误用了受限 Header 名:完整列表见
net/http/transport.go中的isOWS和isToken判定逻辑 - 自定义 Header 建议全小写加中划线(如
"x-request-id"),避免大小写混用导致服务端收不到 - 如果必须发
"Host",得用req.Host = "xxx.com"而不是req.Header.Set("Host", ...)
超时和重定向需显式配置 http.Client
默认 http.DefaultClient 没有设置超时,遇到网络卡死会 hang 住整个 goroutine;而且它默认允许重定向,可能把带敏感 Header 的请求泄露到跳转后的地址。
立即学习“go语言免费学习笔记(深入)”;
- 生产环境务必自定义
http.Client:client := &http.Client{ Timeout: 10 * time.Second, CheckRedirect: func(req *http.Request, via []*http.Request) error { return http.ErrUseLastResponse // 禁止重定向 }, } - 如果要保留重定向但携带 Header,得自己实现
CheckRedirect并手动复制 Header 字段,因为默认重定向会丢掉原始 Header - 别忘了
resp.Body.Close(),否则连接不释放,压测时很快触发too many open files
Header 设置看着简单,但 Go 的静默过滤、自动 Content-Length、重定向行为这几个点,线上出问题时往往查半天才定位到。尤其对接老系统时,多抓包对比 curl 和 Go 发出的原始请求,比看文档快得多。

















