结构体绑定对 Header 完全无效，因为 Iris 的模型绑定（如 ReadJSON、ReadForm）仅作用于请求体或查询参数，Header 属于请求元信息且框架不解析 header tag，需手动通过 ctx.Request().Header.Get() 获取。
不能用结构体自动绑定 Header，必须手动调 ctx.Request().Header.Get() 逐个取值。 Iris 没有类似 ReadJSON 那样的 ReadHeader 方法，Header 是原始 map，框架不提供反射式绑定逻辑。
为什么结构体绑定对 Header 完全无效
Iris 的模型绑定（如 ReadJSON、ReadForm）只作用于请求体（body）或查询参数（query），Header 属于请求元信息，不在绑定路径内。即使你在结构体字段上加 header:"X-Request-ID" 这类 tag，Iris 也完全忽略——它根本不解析 header tag。
- 常见错误现象：
type Req struct { TraceID string `header:"X-Trace-ID"` }+ctx.ReadJSON(&req)，结果req.TraceID始终为空 - Header 和 body 解析是两条独立通道：一个走
ctx.Request().Header，一个走ctx.ReadXXX() - 想“统一绑定”所有来源参数？得自己写中间件提前提取并存到
ctx.Values()，再在 handler 里取
正确读取 Header 的实操方式
直接访问 ctx.Request().Header，它是标准 http.Header 类型，支持大小写不敏感的 Get() 方法：
- 提取单个值：
ctx.Request().Header.Get("Authorization")、ctx.Request().Header.Get("X-Forwarded-For") - 注意大小写：
ctx.Request().Header.Get("accept")和ctx.Request().Header.Get("Accept")效果一样 - 获取多值（如多个
Set-Cookie）：ctx.Request().Header["Cookie"]返回[]string，但通常用Get("Cookie")更安全 - 别漏判空：
if auth := ctx.Request().Header.Get("Authorization"); auth == "" { ... }，空字符串不等于未设置
容易被忽略的 Header 读取陷阱
Header 看似简单，但在代理、CDN、HTTPS 降级等场景下极易失效：
-
X-Real-IP或X-Forwarded-For可能被伪造，不能直接信任；若用 Nginx 转发，需确认它是否设置了proxy_set_header X-Real-IP $remote_addr; - 本地开发用
http://localhost:8080时，Cookie带Secure=true就不会发送，导致ctx.Request().Header.Get("Cookie")返回空 - 前端用
fetch发请求，默认不带Credentials，Authorization头可能被浏览器过滤——需显式加credentials: 'include' - 某些 CDN（如 Cloudflare）会清洗或重写 Header，比如把
X-User-ID改成Cf-Connecting-IP，得查实际转发规则
Header 不是“可选参数”，而是请求上下文的关键部分；手动取值虽啰嗦，但控制力最强。别试图绕过它去搞自动绑定，那只会浪费调试时间。
