灰度发布按用户分流,网关里写的是 uid 对 100 取模小于 10,期望 10% 的用户进新版本。上线当天客服收到十几条反馈,页面一会儿新一会儿旧,刷新一次就变。
先看网关日志,同一个 uid 相邻两次请求落在不同版本。取模的输入是 uid,值本身不会变,除非取模之前 uid 是空的。
确实如此。灰度规则放在最外层,未登录用户没有 uid,取到空串,取模变成 0,全部命中灰度。登录之后 uid 有值,又落回旧版本。接口请求和静态资源请求走不同链路,一个带 Cookie 一个不带,前后端版本就错开了。
第一版改法是用 deviceId 兜底,cookie 里没有就现发一个。问题是 deviceId 由前端生成,同一用户在 App 和浏览器上是两个值,还是会跳。
最终统一成哈希,取模前先算一次 crc32,分母放到 1000,避免小样本下分布不均:
local key = ngx.var.cookie_uid or ngx.var.cookie_did
if not key or key == "" then
key = ngx.var.remote_addr
end
local bucket = ngx.crc32_long(key) % 1000
if bucket < 100 then
ngx.var.target = "app_canary"
end
拿不到 cookie 时退到 IP,同一个出口 NAT 下的一批用户会集中到同一侧,这个偏差可以接受,总比来回跳好。
还发现扩容会破坏分流。之前分母写的是实例数,从 6 台扩到 8 台,同一个 uid 的桶号全变了。分母必须和实例数无关,固定 1000 存进配置中心。
确认方式:拿 50 个真实 uid 各请求 100 次,全部落在同一版本;再统计一天的灰度侧 UV,占比 9.8%,接近设定的 10%。
前端也在页脚打上版本号,客服反馈时看一眼就知道走的是哪一侧,省掉一半沟通。
