context.value 存灰度标签最稳妥方式是用私有空 struct 类型作 key（如 type graytagkey struct{}），值存校验后的字符串，取值时用同一 key 类型断言；http 从 header 或 query 提取后须正则校验（^[a-za-z0-9_-]{1,32}$），grpc 需手动透传 metadata，goroutine 中必须显式传入 context。
Context.Value 里存什么格式的灰度标签最稳妥
直接存字符串或结构体都行，但必须确保类型安全——context.WithValue 的 key 必须是自定义类型（不能用 string），否则跨包传递时容易键冲突。推荐用私有空 struct 指针做 key：
type grayTagKey struct{}
然后用 context.WithValue(ctx, grayTagKey{}, "v2-canary") 存值。取的时候也必须用同一 key 类型强制断言，比如 ctx.Value(grayTagKey{}).(string)，否则 panic。
常见错误：用 "gray_tag" 这种字符串当 key，结果中间件、RPC 框架、日志库各自定义同名 string key，互相覆盖。
HTTP 请求进来的灰度标签怎么塞进 Context
通常从 header（如 X-Gray-Tag）或 query（?gray=v2）提取，但要注意校验和清洗——不能原样透传用户可控输入。
- 只允许字母、数字、下划线、短横线，长度限制在 32 字符内
- 若 header 不存在或不合法，建议 fallback 到空字符串或默认分组，而不是丢弃整个 context
- 别在 handler 里反复解析：一次解析后就塞进 context，后续中间件和业务逻辑统一从
ctx.Value()取
示例：r.Header.Get("X-Gray-Tag") 提取后，先正则匹配 ^[a-zA-Z0-9_-]{1,32}$，再写入 context。
gRPC 服务里怎么透传灰度标签
gRPC 默认不自动传播 HTTP header，得手动把灰度标签从 metadata.MD 提出来，再塞进下游调用的 context。
- 服务端用
grpc.Peer或metadata.FromIncomingContext(ctx)拿 header - 客户端发起调用前，用
metadata.Pairs("x-gray-tag", tag)构造 metadata，再用grpc.MetadataCarrier注入到 context - 注意：gRPC 的 metadata key 会自动转成小写加横线（
X-Gray-Tag → x-gray-tag），所以服务端取时要用小写形式
漏掉 metadata 注入是常见问题——光改了本地 context，没传给下游 gRPC 调用，导致灰度逻辑在第二跳就失效。
中间件或异步任务里 Context 丢失灰度标签怎么办
goroutine 启动时若没显式传入 context，或者用了 context.Background()，标签就丢了。尤其在定时任务、消息消费、数据库回调等场景里特别容易踩坑。
- 所有 go func() 都要接收 context 参数，不要闭包捕获外部 ctx
- 用
context.WithTimeout(parentCtx, ...)替代context.Background() - 数据库查询、Redis 调用等 I/O 操作，如果封装了 client，确保其方法签名带 context 参数，并透传下去
最隐蔽的问题：某个日志中间件用了 log.WithField("gray", ctx.Value(...))，但 ctx 是从 http.Request.Context() 拿的，而该请求中途被 cancel 或超时，value 就变成 nil——得加非空判断，不然日志 panic。
