必须在c.json()之前调用c.header()设置content-type，否则会被gin内部逻辑覆盖；因http.responsewriter.header()允许多次设置且后写入者生效，故前置设置方可成功覆盖。
用 c.Header() 设置响应头必须在 c.JSON() 之前
很多人写 c.Header("Content-Type", "application/json; charset=utf-8") 却发现没生效，根本原因是调用了 c.JSON() 后 Header 被 Gin 内部覆盖了。Gin 的 c.JSON() 会自己写一次 Content-Type，而 http.ResponseWriter.Header() 允许多次 Set，但后写入者胜出。
- 正确顺序：先
c.Header()，再c.JSON()或c.String() - 错误写法：
c.JSON(); c.Header()—— 此时 Header 已提交，再 Set 无效 - 若需统一处理，建议封装成中间件或自定义响应函数，避免每处都手写顺序
c.ShouldBindHeader() 绑定结构体时 header 标签名必须匹配实际存储 key
Gin 的 ShouldBindHeader 底层调用的是 http.Header.Get()，而标准库对 Header key 做了规范化：首字母大写、其余小写（如 authorization → Authorization，x-user-id → X-User-Id）。你写的 struct tag 必须跟这个规范化后的 key 完全一致，否则取不到值。
在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface
- 调试第一件事：
fmt.Printf("%+v", c.Request.Header)看真实 key 是什么 - 标准头推荐直接用规范写法：
Authorization、Content-Type - 自定义头别乱写连字符：
X-Trace-ID实际存为X-Trace-Id，所以 tag 得写X-Trace-Id - 大小写敏感：写成
authorization或AUTHORIZATION都会失败
发送请求时不能用 http.Get()，必须用 http.NewRequest()
Gin 框架本身不负责发外网请求，它只处理进来的 HTTP 请求。如果你要在 Gin handler 里调用第三方 API 并带自定义 Header（比如 X-API-Key），http.Get() 和 http.Post() 是拦路虎——它们内部新建 *http.Request，Header 字段被锁定，你完全没法插手。
- 唯一可靠路径：
req, _ := http.NewRequest("GET", url, nil)，然后req.Header.Set() - 注意 Host 头：不要手动设
Host，它由 URL 解析自动填充；强行 Set 可能触发 400 - 认证头推荐用
req.Header.Set("Authorization", "Bearer xxx")，而非拼到 URL 里 - 如果大量复用相同 Header，可提前构造
http.Header对象再赋给req.Header
Gin 自定义 HTTP 配置影响 Header 处理边界
虽然 Gin 本身不直接限制 Header 大小或编码，但底层 http.Server 的配置会影响你能收到/发出的 Header 行为。比如反向代理传过来超长的 X-Forwarded-For，或者客户端塞了 2MB 的自定义追踪头，没调大 MaxHeaderBytes 就会直接 431 Request Header Fields Too Large。
- 启动时显式配置
http.Server：设置MaxHeaderBytes（默认 1MB），按需调大 -
ReadTimeout和WriteTimeout不直接影响 Header 内容，但超时会导致 Header 未写完就被中断 - Gin 的
gin.Engine本身没有 Header 相关配置项，所有底层控制都来自http.Server - 若用 Nginx 做前置代理，还要检查
large_client_header_buffers，否则 Gin 根本收不到完整 Header
c.Header() 与序列化方法的执行顺序。这两点不验证，代码跑起来永远“看起来没问题，但就是不生效”。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
