金丝雀发布应直接在入口 handler 中读取请求头（如 X-Canary）做路由分发，避免中间件链式劫持；需注意 Context 取消检查、Header 安全读取、代理时手动控制 Director 和 Transport，并用 sync.Map 管理健康状态。
用 net/http + 请求头做路由分发，别碰中间件链式劫持
金丝雀发布在 Go 里本质是「按请求特征做路由决策」，不是改部署或加代理层。最轻量、最可控的方式是直接在 HTTP handler 里读 req.Header.Get("X-Canary") 或 req.URL.Query().Get("version")，然后分发到不同业务逻辑函数。中间件（比如用 gorilla/mux 的 MiddlewareFunc）容易把路由逻辑和业务耦合，后续加灰度策略（如按用户 ID 哈希）时难调试。
常见错误现象：panic: runtime error: invalid memory address —— 多半是中间件里没检查 req.Context() 是否已 cancel，或在写完 response 后还试图操作 http.ResponseWriter。
- 只在入口 handler（如
http.HandleFunc("/", handler)）做一次判断，避免多层嵌套后 header 被覆盖或丢失 - 优先用请求头（
X-Canary）而非 cookie 或 query，方便压测工具（如hey）批量构造流量 - 不要在 handler 里 new struct 或开 goroutine 做路由判断——Go HTTP server 默认复用
http.Request，但Header是 map，可安全读取
gorilla/handlers 的 ProxyHandler 不适合金丝雀，用 httputil.NewSingleHostReverseProxy 自己封装
有人想用反向代理把部分请求转给新版本服务，结果发现 gorilla/handlers.ProxyHandler 没暴露底层 RoundTripper 控制权，无法动态改 Director 函数。真要代理，必须自己用 httputil.NewSingleHostReverseProxy 包一层，手动控制转发逻辑。
使用场景：老服务跑在 :8080，新版本跑在 :9090，你想让 user_id=12345 的请求打过去验证。
立即学习“go语言免费学习笔记（深入）”；
- 在
Director函数里解析req.Header.Get("X-User-ID")，用sha256.Sum32哈希后对 100 取模，< 5就改req.URL.Host = "localhost:9090" - 务必设置
proxy.Transport = &http.Transport{...}，否则默认 transport 会复用连接但不处理 HTTP/2 或 keep-alive 超时，导致新版本服务收不到 Host 头 - 别忘了拷贝原始请求的 header：
outReq.Header.Set("X-Forwarded-For", req.RemoteAddr)，否则下游服务拿不到真实 IP
用 sync.Map 存活检查结果，别轮询或依赖外部配置中心
金丝雀阶段需要监控新版本健康状态（比如 5 分钟内错误率 sync.Map 缓存每个 endpoint 的最近 100 次响应码，每次请求结束时更新；另起一个 time.Ticker 每 30 秒扫一次，算错误率并写入本地 atomic.Bool 标志位。
性能影响：100 次记录仅占几百字节内存，比 JSON 解析配置、HTTP 轮询接口快两个数量级，且无单点故障。
- key 用
"canary:http://localhost:9090/health"这种字符串，value 是[]int{200,500,200,...}，长度超 100 就截断 - 错误率计算别用浮点除法——用
errors * 100 / len(records) < 1避免 float64 精度问题和 GC 压力 - 如果新版本挂了，
sync.Map里对应 key 会自然停止更新，30 秒后标志位自动翻回 false，流量自动切回旧版
上线前漏掉的三个硬坑：TLS SNI、gRPC metadata、k8s Service 的 EndpointSlice
Go 服务跑在 k8s 里时，光写对 handler 没用。金丝雀流量可能根本到不了你的 Pod——因为 ingress controller（如 nginx-ingress）或 service mesh（如 istio）默认按 service name 路由，不看你代码里的 header 判断。
容易被忽略的地方：
- k8s
Service的spec.selector必须同时匹配新旧版本的 label（比如都带app: mysvc），否则 EndpointSlice 只会包含其中一种 Pod - 如果用了 HTTPS，客户端必须传
ServerName（SNI），否则 TLS 握手失败——http.Client默认不设，得显式传&http.Client{Transport: &http.Transport{TLSClientConfig: &tls.Config{ServerName: "mysvc.example.com"}}} - gRPC 场景下，
metadata.MD里的键名默认小写，md.Get("x-canary")才能取到，用Get("X-Canary")会返回空
事情说清了就结束
