灰度发布必须在运行时实现请求级动态决策，编译标签仅支持构建时静态裁剪，无法支持per-request分流、比例控制、白名单更新等核心需求。
灰度发布不能靠编译标签解决，它和功能开关（Feature Flag）是两件事；编译标签只影响构建时的代码包含，无法实现 per-request 分流、动态调整比例或运行时白名单。
编译标签（build tags）只适用于构建时静态裁剪
比如你有实验性压缩算法，想在特定环境才编译进二进制：用// +build compress_zstd标记文件，再go build -tags compress_zstd。但一旦编译完成，这个“开关”就固化了——重启服务、改配置、发请求都改变不了它是否生效。
常见误用：// +build gray 包裹整个 handler，然后上线两个 binary（gray 和 stable）靠 K8s Service 切换。这根本不是灰度发布，是手动蓝绿，无法做 5% 流量测试、无法按用户 ID 精准控制、也无法热更新规则。
- 编译标签不感知 HTTP 请求上下文，没法读
r.Header.Get("X-Gray-Id") - 无法支持灰度策略变更（比如把白名单从 10 个用户扩到 100 个），必须重新构建+部署
- 和
context.Context、中间件、配置中心完全脱节，违背灰度“动态、可审计、可回滚”的核心诉求
灰度发布必须在运行时做请求级决策
真正可用的灰度，是在 http.ServeHTTP 入口用中间件判断每次请求该走哪条逻辑路径。关键点是：规则必须本地可评估、无副作用、线程安全。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
典型做法是封装一个只读的策略对象：
type GrayStrategy struct {
whitelist map[string]bool
ratio int // 0–100
re *regexp.Regexp
}
func (s *GrayStrategy) Match(r *http.Request) bool {
id := r.Header.Get("X-User-Id")
if id == "" {
id = r.URL.Query().Get("uid")
}
if s.whitelist[id] {
return true
}
if s.re.MatchString(id) {
return true
}
if id != "" {
h := fnv.New32a()
h.Write([]byte(id))
return h.Sum32()%100
- 所有字段初始化后不再修改，避免并发写 panic
-
regexp.MustCompile提前编译好，别在Match()里反复Compile - 哈希用
fnv而非rand，保证同一用户始终命中相同分支 - 绝对不要在
Match()里调http.Get或查 DB —— 单点失败会拖垮整条链路
功能开关（Feature Flag）该用 SDK 而非自己硬编码
如果你真需要“某个功能对部分用户开启”，直接上 go-feature-flag 或 unleash-client-go。它们解决的是「策略表达」和「运行时生效」问题，不是编译时开关。
例如用 go-feature-flag 判断是否启用新支付流程：
ctx := ffcontext.NewEvaluationContextWithUserKey("u12345")
enabled, _ := ffclient.BoolVariation("new-payment-flow", ctx, false)
if enabled {
// 走新逻辑
} else {
// 走旧逻辑
}
-
new-payment-flow必须全小写+连字符，YAML 配置里也得严格一致 -
ctx必须是ffcontext.Context类型，传字符串会静默 fallback -
false是 fallback 值，仅当 SDK 初始化失败或 key 不存在时返回，不参与规则计算 - 配置变更通过文件监听或 etcd watch 实时更新，无需重启进程
最常被忽略的一点：灰度中间件和功能开关 SDK 必须共用同一套用户标识解析逻辑。如果中间件从 X-User-Id 取 ID，而 go-feature-flag 却从 JWT payload 里取 sub 字段，那分流结果必然错乱——用户在灰度中间件里被放行，却在功能开关里被拒，排查起来毫无头绪。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
