【案例复盘】结义加成重复发放：协同Buff的重复结算复盘

实战应用：用在哪里

结义合击玩法上线三天，客服收到“攻击加成叠了三层”的报告：同一次合击，三个入口各挂了一次加成Buff。复盘把重复结算的三个源头逐个封堵，Buff发放从此有了唯一出口。

事故的还原

合击触发在技能触发、队列唤醒、补发逻辑三处都调用了加成接口，设计上以为只有技能触发会走，实际上队列超时补发与断线重连补发也会命中同一条件。

function comboCastV1(actor)
    addbuff(actor, "SWORN_POWER", 30)
    queueDelayBonus(actor)
end
function queueDelayBonus(actor)
    addbuff(actor, "SWORN_POWER", 30)
end

同一玩家同一时间窗的三次调用，引擎按叠加处理，攻击加成翻了三倍。

唯一出口的补丁

补丁把Buff发放收敛到唯一函数：发放前查生效标记，同一时间窗内重复请求直接跳过。

local function grantOnce(actor)
    local player = class(actor)
    local last = tonumber(getplayvar(actor, 2, "SWORN_TS") or "0")
    if os.time() - last < 30 then
        return
    end
    setplayvar(actor, "HUMAN", "SWORN_TS", os.time(), 1)
    addbuff(actor, "SWORN_POWER", 30)
end

验证与监控

三个入口并发触发的用例验证只发一次；三十秒窗口边界精确断言。上线后用Buff快照比对追踪同类重复，任何Buff的持有时长超过设计上限即告警，重复发放从被动投诉变主动发现。

踩坑记录

唯一出口的收敛要列出所有历史调用点逐一改造，漏改一个入口就是漏堵一个源头，全局搜索加成函数名是最笨也最可靠的办法。时间窗三十秒按合击冷却对齐，窗口大于冷却会吃掉合法的第二次加成。Buff快照比对的做法可以推广到所有增益类玩法，增益超限的告警阈值设设计值加一成。事故里最刺眼的是三个入口的代码注释都写着“仅此一处发放”，注释与事实不符比没有注释更害人。