【案例复盘】跨服战场积分回滚的事故复盘

实战应用：用在哪里

跨服战场周日结算夜出了双事故：30 名玩家积分凭空翻倍，随后 12 名玩家积分变成负数。两条线索指向同一根源——结算链里积分写入与标记写入是两步，中间失败时只回滚了一步。复盘整条结算链的补丁与治理，价值不在追回积分，在把幂等与标记的纪律固化进结算框架。

事故链还原与幂等补丁

结算四步：取排名、算积分、写积分、写结算标记。跨服库抖动时第三步成功第四步失败，重跑链路的幂等检查只认标记，标记缺失就再算一遍积分，翻倍由此而来；另一分支先写标记后写积分，失败后积分回滚标记残留，重跑直接跳过，缺口对不上账。补丁把结算压成带场次号幂等键的单入口：

function settle(actor, roundId)
    local key = "SETTLE_" .. roundId
    if tonumber(getplayvar(actor, "HUMAN", key) or "0") == 1 then return end
    local pt = calcScore(actor)
    setplayvar(actor, "HUMAN", "ARENA_PT", pt, 1)
    setplayvar(actor, "HUMAN", key, 1, 1)
end

存量修复与对账

补丁上线后跑存量修复：按结算流水重放，多发积分按流水差额扣回，负数积分以流水为准复位，每次修复发消息留痕。

function repair(actor, roundId, truePt)
    local key = "SETTLE_" .. roundId
    if tonumber(getplayvar(actor, "HUMAN", key) or "0") ~= 1 then return end
    setplayvar(actor, "HUMAN", "ARENA_PT", truePt, 1)
    sendmsg(actor, 0, "跨服积分已按 " .. roundId .. " 场次流水校准")
end

验证与监控

故障注入在第四步断开，重跑结算核对积分不再翻倍；负数样本修复后与流水逐条一致；修复名单 30 人短信逐个通知。监控结算完成率与重跑次数，同一场次重跑超过 3 次自动冻结转人工。修复脚本的执行账号与结算进程隔离，防止修复动作误入结算链路。

踩坑记录

幂等键按场次号隔离后才真幂等，早期全局一个键，第二场结算被第一场的标记挡住全场不发积分，玩家以为奖励被吞。修复扣回可能把玩家扣成负数，低于零按零处理并单独标注名单，避免修复引发二次事故。跨服库抖动集中在周日 21 点结算高峰，结算错峰到 22 点半后连续四周零复发。流水表当初没存场次号，修复只能按时间窗重放，多耗一整天，流水表从当周起补了场次字段与唯一索引。翻倍事故里最早的 30 个受害账号，正是靠带场次号的流水才逐笔算清差额。