Go HTTP中间件透传X-Request-ID和X-Env需在首层中间件提取并写入context.Context，HTTP出站请求手动Set头，gRPC调用通过metadata注入，避免使用c.Set和http.Post等易丢header的方式。
Go HTTP 中间件如何提取并透传 X-Request-ID 和 X-Env 染色头
灰度流量的核心是“染色头”能贯穿全链路，但 Go 的 http.Handler 默认不自动继承上游请求头，下游服务也容易忽略透传。必须在每个出站 HTTP 请求中显式拷贝关键头字段。
- 只信任
X-Request-ID（用于链路追踪）和X-Env（用于灰度路由）两个头，其他如X-Forwarded-For不参与染色逻辑，避免污染 - 用
req.Header.Set("X-Env", req.Header.Get("X-Env"))而非Clone()，因为http.Request.Clone()在 Go 1.19+ 才支持完整 Header 复制，旧版本会丢 header - 下游调用 gRPC 时，需通过
metadata.MD手动注入，例如：metadata.Pairs("x-env", r.Header.Get("X-Env"))
gin.Context 如何安全读取染色头并写入 context.Context
直接从 c.Request.Header 读值看似简单，但 gin 的 c.Request 可能在中间件链中被重写（比如用了 gin.Recovery() 后的 panic 恢复逻辑），导致 header 丢失；必须在第一个中间件里完成染色头提取并塞进 c.Request.Context()。
- 在最外层中间件用
ctx := context.WithValue(c.Request.Context(), "env", c.Request.Header.Get("X-Env"))，不要用字符串 key，定义常量const CtxEnvKey = "gray-env" - 避免用
c.Set()存染色信息——它只在当前 gin.Context 生效，无法穿透到子 goroutine 或下游 HTTP 客户端 - 如果用了
gorilla/handlers.CompressHandler等第三方中间件，注意它们可能替换http.ResponseWriter，但不会动Request.Context()，所以 value 是安全的
Go client 发起 HTTP 请求时怎么保证染色头不被丢
http.DefaultClient 不会自动携带父请求的 header，更不会识别 X-Env；必须手动构造新 request，并确保 transport 层不拦截或覆盖自定义头。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 别用
http.Post()这类快捷函数——它们创建的 request 没有 parent context，header 全空 - 正确做法：用
http.NewRequestWithContext(ctx, "GET", url, nil)，再手动req.Header.Set("X-Env", env) - 若使用
net/http/httptrace做链路追踪，注意httptrace.ClientTrace.GotConn阶段无法修改 header，必须在 request 创建后、Do()前设置 - 某些代理（如 Istio Envoy）默认 strip 非标准 header，需在
DestinationRule中配置trafficPolicy.portLevelSettings显式放行X-Env
如何验证染色头是否真正透传到下游服务
本地调试时看到 header 存在，不代表生产环境也生效——Kubernetes Service、Ingress、Sidecar 都可能过滤或重写 header。
立即学习“go语言免费学习笔记（深入）”；
- 在下游服务入口打日志：
log.Printf("received X-Env: %s", r.Header.Get("X-Env"))，不要只查curl -v输出 - 检查 Istio 的
VirtualService是否启用了headers.request.set覆盖了原始头 - 用
tcpdump抓 pod 网卡包（如tcpdump -i eth0 -A port 8080），确认 wire 上真实发送的 HTTP 请求是否含X-Env - 注意 Go 的
http.Transport对大小写不敏感，但某些反向代理（如 Nginx）默认转小写，建议统一用X-Env而非x-env避免歧义
染色不是加个 header 就完事，关键是每跳都得有人“接住”并“递出去”。最容易漏的是 sidecar 注入后的 header strip 行为，以及 Go client 里忘了设 context 或 header 的那一行代码。
