【数据存储】离线数据：异步邮件与离线奖励投递

实战应用：用在哪里

拍卖成交、好友赠礼、活动奖励，收件人常常不在线。离线投递统一走邮件系统：写库即返回成功，上线时拉取未读邮件，投递方永远不被收件方的在线状态阻塞。传奇引擎里邮件承载了经济与社交两条线的异步结算。

邮件写入

function Mail.send(toId, title, items, expireDays)
    local mail = {
        to = toId, title = title, items = items,
        at = os.time(), expireAt = os.time() + expireDays * 86400,
        read = false,
    }
    mailbox[toId] = mailbox[toId] or {}
    local box = mailbox[toId]
    if #box >= 100 then return false, "收件箱已满" end
    box[#box + 1] = mail
    QF_PersistMail(toId, mail)
    return true
end

收件箱上限 100 封，超满退回发件方并告知。邮件带附件独立落库，附件在领取前受系统保护，角色删除时未领附件自动折算返还。

上线拉取

function Mail.onLogin(plr)
    local box = mailbox[plr.id] or {}
    local unread = 0
    for i = #box, 1, -1 do
        local m = box[i]
        if m.expireAt < os.time() then
            table.remove(box, i)
        elseif not m.read then
            unread = unread + 1
        end
    end
    if unread > 0 then QF_PushMailCount(plr, unread) end
end

登录时清理过期邮件再推送未读数，附件领取即时到账并置已读。过期未领的带附件邮件延长 7 天并二次提醒，防止奖励蒸发引发客诉。邮件列表用 GUI:ListView 渲染，带附件的条目亮显领取按钮，一键领取按序结算。

踩坑记录

邮件附件的独立落库是丢附件事故后的产物，早期附件嵌在邮件体里，邮件体损坏附件跟着陪葬，分离之后附件有自己的生命周期。一键领取的按序结算曾经被批量领取打断，领到一半的附件状态不一致，领取动作改成事务化后杜绝。未读数的推送时机也有讲究，登录即推与每封即推两种策略 A/B 过，登录汇总一次的打扰感知最低而点击率最高。邮件的全文检索曾经是运营的刚需，排查活动奖励发放范围时按标题模糊搜索能省大量时间，检索索引按月构建维护。附件的物品快照设计让邮件里的道具不受后续调价影响，玩家收到时是什么就是什么，与发放时刻一致。离线投递的延迟监控按来源分类，活动批量发放的队列与玩家点对点赠礼分开发送，大流量永远不挤占社交链路。邮件的全文检索曾经是运营的刚需，排查活动奖励发放范围时按标题模糊搜索能省大量时间，检索索引按月构建维护。附件的物品快照设计让邮件里的道具不受后续调价影响，玩家收到时是什么就是什么，与发放时刻一致。离线投递的延迟监控按来源分类，活动批量发放的队列与玩家点对点赠礼分开发送，大流量永远不挤占社交链路。

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