【案例复盘】限时礼包少发一天的事故复盘

实战应用：用在哪里

开服七日限时礼包发到第六天断了粮，9 月 1 日当天领奖按钮灰的，投诉当天破千。事故根因是一条数字日期循环：8 月 30 日加一写成 20260831，再加一变成 20260832，这个日期永远不会等于真实的 9 月 1 日，发放循环静默断链。复盘把日期处理全部收敛到时间戳推进。同类隐患排查扩展到所有按日期循环的活动，一次性消灭三处同类写法。

事故链还原与补丁

旧实现把日期当整数自增，跨月即断链。补丁用时间戳推进加 os.date 格式化，跨月跨年都不会跳号，幂等键按日隔离。

local function grantDaily(actor, startTs, days)
    for i = 0, days - 1 do
        local day = os.date("%Y%m%d", startTs + i * 86400)
        if tonumber(getplayvar(actor, "HUMAN", "GIFT_" .. day) or "0") == 0 then
            giveitem(actor, "限时礼包", 1)
            setplayvar(actor, "HUMAN", "GIFT_" .. day, 1, 1)
        end
    end
end

存量补发与安抚补偿

补发脚本按活动日历重放七个自然日，漏发的一天逐账号补上，另发 20000 金币礼券作为体验补偿，名单短信告知。

local function repair(actor, startTs, missDay)
    local day = os.date("%Y%m%d", startTs + missDay * 86400)
    if tonumber(getplayvar(actor, "HUMAN", "GIFT_" .. day) or "0") == 0 then
        giveitem(actor, "限时礼包", 1)
        setplayvar(actor, "HUMAN", "GIFT_" .. day, 1, 1)
    end
    giveitem(actor, "金币礼券", 20000)
    sendmsg(actor, 0, "漏发的礼包已补上，另有小小赔礼")
end

验证与监控

跨月边界单测覆盖 8 月 31 日、12 月 31 日、闰年 2 月 29 日三个坑位；补发幂等验证重跑十次只补一次；发放时段抽查零点前后的边界账号。补发覆盖范围按领取流水圈定，未受影响账号不进名单，避免补偿范围盲目扩大。受影响的 3400 个账号分三批补发，客服侧同步话术，二次投诉率控制在千分之三以内。监控限时礼包的每日领取量曲线，断崖式下跌直接告警到值班，不再等投诉。

踩坑记录

数字日期自增的写法在评审时被认为没问题，因为上周刚发过 8 月的活动没人跨月，跨月单测从此成为日期类需求的必跑项。补发脚本第一版没带幂等键，重复执行给同一账号塞了七份礼包，键按日隔离后才敢全量跑。零点前后 5 分钟登录的账号时区偏差漏发，统一以服务器时钟为准而不是登录会话时钟。补偿金额 20000 是按礼包市价折算，玩家更在意断档破坏了七日连续奖励的完整感，后续活动把断档保护做成规则：漏领当日 48 小时内可补领。