【工具链】灰度发布：按账号尾号放量与回滚

实战应用：用在哪里

新玩法上线先放 10% 玩家试用，观察一小时错误率与付费曲线，没问题放量到全量，有问题秒级回滚，灰度是运维手里最便宜的保险。传奇引擎的灰度开关按账号尾号切流，秒级生效，不需要重启进程，玩家无感知地在新旧逻辑间被分配。

灰度切流

local GRAY_PERCENT = 10
function Gray.enabled(plr, featureKey)
    local flag = featureFlags[featureKey]
    if not flag or not flag.on then return false end
    local tail = plr.id % 100
    return tail < flag.percent
end

账号尾号取模 100，小于放量百分比即命中，同一账号永远落在同一侧，体验不会来回跳。切流维度可扩展：按行会、按地图、按渠道包切流的策略各自实现 enabled 接口，调用方无感知。灰度名单支持白名单强制命中，内部账号先行体验是固定流程。

放量与回滚

function Gray.setPercent(featureKey, percent)
    local flag = featureFlags[featureKey]
    if percent < flag.percent and percent > 0 then
        QF_Alarm("灰度收量需审批", featureKey)
        return false
    end
    flag.percent = percent
    Gray.persist()
    QF_NotifyGM("灰度调整", featureKey .. "=" .. percent .. "%")
    return true
end

放量直接改，收量需二次审批防止误操作把故障面扩大。紧急回滚把 flag.on 置 false，全部请求立刻走旧逻辑，无须重启进程，从决策到生效 10 秒内完成。灰度期间的错误率按功能维度单独统计，超过基线 3 倍自动告警提示收量，告警带最近 20 条错误样本，值班同学不用再翻日志。每次灰度调整都进操作日志，谁放的量、什么时候放的、依据什么数据，回溯链路完整。

验证与监控

灰度组与对照组的核心指标差异自动产出日报，显著劣化的功能不再进入下一轮放量。

踩坑记录

白名单强制命中曾经漏了缓存层，内部账号看到的是缓存的旧逻辑结果，一度以为灰度失效，缓存键加特性版本号后生效判定绝无歧义。收量审批的第一版流程被值班同学抱怨救火太慢，紧急场景的事后补审通道 24 小时内补单即可。灰度日报的对照组选取讲究，按尾号取模天然随机但小服样本少，日报里标了置信度提示，数据人看的报告自己要诚实。

本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付，内容以官方知识库与真实项目为出处，按版本持续修订。