0

0

如何使用Golang实现HTTP请求Header修改_Golang net/http Header操作示例

P粉602998670

P粉602998670

发布时间:2026-01-24 16:47:02

|

660人浏览过

|

来源于php中文网

原创

在Golang中设置请求Header需用req.Header.Set或Add方法,且必须在http.DefaultClient.Do前完成;自定义Host头须设req.Host字段;Content-Type需在NewRequest后设置;不可手动设Content-Length或Transfer-Encoding。

如何使用golang实现http请求header修改_golang net/http header操作示例

如何在 Golang 中正确设置请求 Header

直接赋值 req.Header 不生效,因为 http.NewRequest 创建的请求对象默认会冻结 Header(尤其是当 URL scheme 为 httphttps 时),必须在调用 http.DefaultClient.Do 前完成设置,且需使用 req.Header.Setreq.Header.Add 方法。

  • req.Header.Set("User-Agent", "my-app/1.0"):覆盖已有同名 Header(推荐用于单值字段,如 User-AgentContent-Type
  • req.Header.Add("Cookie", "sid=abc"):追加字段(适用于可重复 Header,如 CookieX-Forwarded-For
  • 不能写 req.Header["User-Agent"] = []string{"..."} —— 这种直接赋 map 的方式会被底层忽略
  • 如果请求是通过 http.NewRequestWithContext 构建的,Header 设置时机不变,仍需在 Do 前完成

为什么自定义 Host 头总是被忽略

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 部分将使用该值
  • 注意:若 URL 已含端口(如 http://localhost:8080),而 req.Host 未带端口,则可能触发连接失败;建议保持端口一致
  • HTTPS 场景下,req.Host 还会影响 TLS SNI,务必与目标服务器预期一致

POST 请求中 Content-Type 和 Body 的顺序陷阱

设置 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
  • 若 Body 是 *os.File 或其他流式类型,Content-Length 会自动计算,但 Content-Type 仍需手动指定

避免 Header 被自动添加的常见干扰项

Golang 的 http.Client 会在发送前自动注入若干标准 Header,例如:

koly.club
koly.club

一站式社群管理工具

下载

立即学习go语言免费学习笔记(深入)”;

  • Accept-Encoding: gzip(除非显式禁用:req.Header.Set("Accept-Encoding", "")
  • User-Agent: Go-http-client/1.1(除非显式覆盖)
  • Content-LengthTransfer-Encoding(由 Body 类型自动决定,不可手动设,否则 panic)
  • Connection: keep-alive(HTTP/1.1 默认行为,无法关闭)

若需完全控制输出 Header,最稳妥的方式是:构建 req → 显式 Set 所有需要的字段 → 检查是否意外存在不期望的字段(如打印 req.Header)→ 再调用 Do。尤其注意 Content-LengthTransfer-Encoding 绝对不要手动设置,否则会触发 http: ContentLength=xxx with Body length 0 类错误。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

180

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

228

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

341

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

209

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

393

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

198

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

191

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

273

2025.06.17

c++空格相关教程合集
c++空格相关教程合集

本专题整合了c++空格相关教程,阅读专题下面的文章了解更多详细内容。

0

2026.01.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 8.5万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号