应使用 c.shouldbindheader 并确保结构体 header 标签值与 c.request.header 中实际存储的规范化 key 完全一致，如 authorization（非 authorization）、x-trace-id（非 x-trace-id），否则字段为空且不报错。
如何用 c.ShouldBindHeader 绑定请求头到结构体
不能直接按文档写的标签名瞎写，c.ShouldBindHeader 底层调用的是 http.Header.Get()，而 Go 标准库会把 header key 自动规范化（比如 authorization → Authorization，x-user-id → X-User-Id），但这个规范化结果和你写的 struct tag 必须完全一致，否则取不到值。
常见错误现象：结构体字段始终为空、c.ShouldBindHeader 返回 nil 但字段没填充。
- 调试第一步：打印
c.Request.Header看真实 key 名，例如fmt.Printf("%+v", c.Request.Header) - 标准 header（如
Authorization、Content-Type）按 RFC 写法写 tag：Authorization，不是authorization或auth - 自定义 header（如
X-Trace-ID）要严格匹配打印出的实际 key，实测多数情况下是X-Trace-Id（注意中间是小写 i），不是X-Trace-ID - struct tag 用
header，不是json或form：Token string `header:"Authorization"`
为什么 c.Header("Content-Type", "application/json") 要在 c.JSON() 前调用
因为 c.JSON() 内部会自动设置 Content-Type: application/json; charset=utf-8，且一旦写入就无法覆盖——它调用的是 Writer.Header().Set()，而 HTTP header 的 Set 是覆盖语义，但 c.JSON() 执行后 header 已锁定，再调 c.Header() 无效。
正确顺序必须是：先手动设 header，再调序列化方法。
- ✅ 正确：
c.Header("Content-Type", "application/json"); c.JSON(200, data) - ❌ 错误：
c.JSON(200, data); c.Header("Content-Type", "application/json")（无效果） - 如果要用
c.PureJSON()，它本身不加charset，但也不支持 gzip，慎用于大响应体 - 封装函数时务必把
c.Header()放在c.JSON()前，否则白封装
c.Writer.Header().Set() 和 c.Header() 有啥区别
没区别。c.Header() 就是 c.Writer.Header().Set() 的封装，两者行为完全一致。但 c.Header(key, "") 表示删除该 header，这点容易被忽略。
使用场景集中在需要精确控制响应头的场合，比如：去掉 charset、添加 X-Request-ID、禁用缓存（c.Header("Cache-Control", "no-store")）。
- 删除 header：
c.Header("X-Powered-By", "")（注意第二个参数为空字符串） - 设置多个同名 header（如多个
Set-Cookie）：必须用c.Writer.Header().Add()，c.Header()只能Set，会覆盖前一个 - 不要在中间件里反复调
c.Header()同一个 key，除非你明确想覆盖前值
自定义响应头时容易漏掉的两个细节
一个是 header 设置时机，另一个是是否触发了写响应体。Gin 的 c.Writer 是惰性写入，但只要调了 c.JSON()、c.String() 这类方法，就会立即写 status + header + body，之后再改 header 就晚了。
- 中间件中设置响应头，必须在
c.Next()前，否则 handler 已经写完响应，header 修改无效 - 如果 handler 中用了
c.AbortWithStatusJSON()，它内部也会写响应，此时再设 header 同样失效 - 某些网关或代理（如 Nginx）会主动覆盖或过滤特定 header（如
Server、Content-Length），别依赖它们一定透传
最稳妥的做法：所有关键 header 都在业务 handler 开头显式设置，别指望中间件兜底，也别在 c.JSON() 后补。
