content-type以外的自定义header丢失，主因是go标准库对header键名规范化（如x-request-id→x-request-id），导致直接用原始键名查询失败；其次nginx默认不透传非标header，需配置underscores_in_headers on及proxy_set_header显式转发。
为什么 Content-Type 以外的自定义 Header 会丢失？
Gin 默认只解析标准 HTTP 头（如 Content-Type、Authorization），对非标 Header（比如 X-Request-ID、X-User-Region）不做特殊处理，但也不会丢弃——问题通常出在反向代理或客户端发送方式上。常见现象是：c.Request.Header.Get("X-Request-ID") 返回空字符串，而用 c.Request.Header 打印全部头却发现它存在。这是因为 Go 的 http.Request 对下划线和点号做了规范化：把 X-Request-ID 当作 X-Request-Id 存，但键名大小写敏感，直接用原字符串查不到。
- Go 的
http.Header内部用textproto.CanonicalMIMEHeaderKey标准化键名，X-Request-ID→X-Request-Id - Gin 的
c.Request.Header.Get()是底层http.Header.Get()的封装，同样受此影响 - 若前端用 fetch 发送，需显式设置
mode: 'cors'并在服务端配Access-Control-Expose-Headers，否则浏览器 JS 拿不到非标头
c.Request.Header.Get() 怎么写才可靠？
别硬写原始键名。用 Go 提供的标准化函数生成键，再查：
import "net/textproto"
key := textproto.CanonicalMIMEHeaderKey("x-request-id")
value := c.Request.Header.Get(key)
或者更简单：直接按规范写驼峰形式，因为 X-Request-ID 规范化后就是 X-Request-Id：
- ✅ 正确：
c.Request.Header.Get("X-Request-Id") - ❌ 错误：
c.Request.Header.Get("X-Request-ID")或c.Request.Header.Get("x-request-id") - 注意大小写：首字母大写，连字符后首字母必须大写，其余小写
如何让 Gin 中间件统一提取并透传非标 Header？
如果多个 handler 都要读 X-Trace-ID、X-Forwarded-For 等，建议写中间件预处理，避免重复调用 Get()：
func ParseCustomHeaders() gin.HandlerFunc {
return func(c *gin.Context) {
c.Set("trace_id", c.Request.Header.Get("X-Trace-Id"))
c.Set("region", c.Request.Header.Get("X-User-Region"))
c.Next()
}
}
// 使用
r := gin.Default()
r.Use(ParseCustomHeaders())
-
c.Set()是线程安全的，比全局 map 更适合请求生命周期内共享数据 - 不要在中间件里修改
c.Request.Header（它是只读映射），想改头请用c.Writer.Header().Set()控制响应头 - 若需校验非标头存在性，建议在中间件中做
if value == ""判断并提前c.AbortWithStatusJSON(400, ...)
Nginx 反向代理下非标 Header 不透传怎么办？
这是生产环境最常踩的坑。Nginx 默认过滤掉带下划线的 Header（如 X_User_ID），且对破折号头也有限制。Gin 收不到，不是代码问题，是 Nginx 配置漏了：
- 确保 Nginx 配置含
underscores_in_headers on;（允许下划线） - 在
location块里显式透传：proxy_set_header X-Request-Id $http_x_request_id; - 如果用了
proxy_pass_request_headers off;，必须手动列出所有要透传的头 - 检查 Nginx error log，搜
invalid header能快速定位是否被过滤
另外，Kubernetes Ingress 或 ALB 等网关层也可能默认 strip 非标头，需单独确认其文档中的 header 白名单机制。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
