Go服务无法自动继承Nginx灰度标识，需手动提取Header/Cookie、透传至context并路由；Nginx必须配置proxy_set_header透传，Go需在首中间件中安全读取并存入context，下游HTTP/gRPC调用须显式携带灰度头。
Go 服务无法自动继承 Nginx 的灰度标识，必须手动提取、透传、路由——这是全链路灰度失效的最常见原因。
为什么 Nginx 的 $cookie_version 或 $http_x_gray_id 到不了 Go handler 里
Nginx 可以基于 Cookie、Header 或权重做入口分流，但它只负责把请求转发给 Go 服务；它不会、也不能自动把灰度字段塞进 Go 的 context 或 HTTP 请求体里。Go 的 http.Request 是全新构造的对象，上游 header 需显式读取。
- 现象：Nginx 日志显示
$http_x_gray_id = v2，但 Go 服务里r.Header.Get("X-Gray-ID")返回空字符串 - 原因：要么 Nginx 没配
proxy_set_header X-Gray-ID $http_x_gray_id;，要么 Go 服务没在中间件里调用r.Header.Get - 关键点：Nginx 的变量（如
$cookie_version）不能直接当 Go 的 context key 用；必须先落地为标准 HTTP header，再由 Go 主动提取
gin/echo 中怎么安全提取并存入 context
必须在第一个中间件里完成提取，且不能依赖“上游已传 context”——因为 net/http 不共享 context，每个 handler 都是新 context。
- 正确姿势：写一个
grayMiddleware，调用value := r.Header.Get("X-Gray-ID")或r.Cookie("version")，然后ctx = context.WithValue(r.Context(), grayKey, value) - 不要在 handler 里做判断：灰度路由决策必须早于 DB 连接池初始化、Redis client 构建等耗时操作
- 避免 panic：用
if cookie, err := r.Cookie("version"); err == nil { ... }而不是直接r.Cookie("version").Value - fasthttp 用户注意：
ctx.UserValue("gray-id")是唯一可用方式，且需手动类型断言
下游 HTTP 调用时如何确保灰度头不丢
http.Client.Do() 绝不会自动复制 incoming request headers——这不是 bug，是设计约束。
立即学习“go语言免费学习笔记（深入）”；
- 必须显式设置：
req.Header.Set("X-Gray-ID", grayID)，且要在client.Do(req)之前 - 如果用了封装好的 client（如 resty），检查它是否支持
SetHeadersFromRequest或类似透传开关；否则得自己 wrap - gRPC 场景下，必须用
metadata.Pairs("x-gray-id", grayID)并在 client 和 server 端都注册拦截器处理，grpc.WithInsecure()不会帮你带 metadata - 错误示范：
ctx = context.WithValue(r.Context(), "x-gray-id", v2)→ 然后期望下游 http client 自动读这个 ctx 值（它不会）
和 Nginx 协同时最容易被忽略的配置细节
Nginx 不只是流量入口，它还是灰度规则的“第一道执行者”，但它的行为常被低估或误配。
-
proxy_set_header X-Gray-ID $http_x_gray_id;必须写在location块里，不能只写在server块顶层——否则子 location 可能不继承 - 若用 Cookie 匹配（如
if ($cookie_version = "v2") { set $upstream "backend-v2"; }），记得加proxy_pass http://$upstream;，且upstream块里要定义对应 server - Nginx 默认不缓存带 Cookie 或自定义 header 的请求，但若配了
proxy_cache，需加proxy_cache_bypass $http_x_gray_id;防止灰度流量被缓存污染 - 用
nginx-ingress时，nginx.ingress.kubernetes.io/canary-by-header注解只控制 Ingress 层路由，Go 服务内部仍需自己透传，否则链路断在第二跳
