【性能调优】事件风暴：单帧事件过载的削峰策略

实战应用：用在哪里

行会战开战瞬间，全场上百名成员的攻防事件在同一帧涌入处理逻辑，单帧事件量冲到平时的一百倍，服务端帧耗时直接翻倍。削峰策略给事件处理加一条传送带：单帧只处理固定配额，多余事件排队到下一帧，用可预期的延迟换取平稳的帧耗时。

配额队列的消费骨架

事件先入缓冲队列，每帧从队头取出固定配额处理，配额定为每帧 200 条，处理不完的自然顺延到下一帧。

local buffer = {}
local QUOTA = 200
local function pushEvent(e)
    table.insert(buffer, e)
end
local function consumeFrame()
    local n = math.min(QUOTA, #buffer)
    for i = 1, n do
        local e = table.remove(buffer, 1)
        handleEvent(e)
    end
    return n
end

队列水位监控与扩容信号

缓冲长度每帧统计一次，超过 5000 条说明事件产生速率超过了消费配额，广播扩容信号提醒调整配额或排查事件源头。

setontimerex(209, 5)
function ontimer209()
    if #buffer > 5000 then
        setsysvarex("BUF_ALERT", #buffer, 1)
        sendcentermsg("事件缓冲偏高，正在加速消化")
        consumeFrame()
    end
end

验证与监控

压测模拟每秒两万条事件灌入，单帧处理量稳定在配额内、帧耗时不超预算；水位曲线与消费速率对账一致；扩容信号触发后配额提升一倍消化加快。监控缓冲水位的分钟曲线，持续走高说明配额定低了或者事件源头异常。

踩坑记录

配额消费用 while 循环处理到队列为空，高峰期一帧处理上万条，削峰变成了伪装的直通，硬性配额才是削峰的关键。事件对象直接引用业务数据，排队期间业务改了数据，消费时读到中间状态，事件入队时做一次快照拷贝。水位告警每帧都发造成广播风暴，告警加了 60 秒的冷却窗口。配额参数最初写死在函数里，调整要发版，改成读系统变量后值班可以动态调参。