【数据存储】角色存档：关键数据的快照与增量合并

实战应用：用在哪里

角色存档是玩家一切投入的载体：等级、装备、包裹、进度、社交关系全在里面。存档策略决定宕机时玩家损失多少进度，快照加增量的混合方案让损失窗口控制在 5 分钟以内，写盘压力却只有全量方案的一成。

快照与增量

function Save.snapshot(plr)
    local data = {
        level = plr.level, exp = plr.exp, gold = plr.gold,
        bag = plr.bag, skills = plr.skills, at = os.time(),
    }
    QF_PersistRole(plr.id, data)
    plr.deltaBuffer = {}
end

function Save.delta(plr, field, value)
    plr.deltaBuffer[#plr.deltaBuffer + 1] = { f = field, v = value, at = os.time() }
end

全量快照每 30 分钟落一次，期间的字段变更先进增量缓冲。金币、经验这类高频字段按 5 秒聚合，同一字段只留一个值。

合并与恢复

function Save.merge(plr)
    local data = QF_LoadRole(plr.id)
    for _, d in ipairs(plr.deltaBuffer) do
        data[d.f] = d.v
    end
    QF_PersistRole(plr.id, data)
    plr.deltaBuffer = {}
end

合并按字段顺序覆盖，时间戳只在冲突时仲裁。宕机恢复流程：读最近快照，重放其后增量，玩家最多丢 5 分钟进度。快照时机会避开战斗结算瞬间，先等当前帧结算完成再落盘。存档体积按角色监控，超过 2MB 的角色列出大字段清单优化，装备与包裹占了九成体积。存档接口用 GUI 设置页展示上次保存时间，玩家对进度安全看得见。

验证与监控

每日落盘成功率要求三个九，失败自动重试三次后进人工队列。

踩坑记录

存档体积的监控曾经只是个数字看板，直到某个角色的存档涨到 80MB 把读取拖到 5 秒，大字段清单功能才被提上日程，装备与包裹占了九成体积的结论就是那次排查得出的。快照时机的就绪检测写完后，落盘耗时的高峰毛刺消失了，运维同学说这是那年最舒服的一次优化。存档接口在设置页展示上次保存时间，一句小文案让进度焦虑的工单少了一半。快照的压缩策略经过两版迭代，早期不压缩时单服一天的角色快照占四个吉字节，引入列级去重后体积降到六分之一。存档的字段版本号让回滚兼容成为可能，新字段在旧代码读取时被跳过而不是报错，双向兼容是存档系统的基本修养。存档相关的告警接入了值班手机，落盘失败五分钟内必须有人响应，这个响应等级与支付回调同级，数据安全没有折扣价。快照的压缩策略经过两版迭代，早期不压缩时单服一天的角色快照占四个吉字节，引入列级去重后体积降到六分之一。存档的字段版本号让回滚兼容成为可能，新字段在旧代码读取时被跳过而不是报错，双向兼容是存档系统的基本修养。存档相关的告警接入了值班手机，落盘失败五分钟内必须有人响应，这个响应等级与支付回调同级，数据安全没有折扣价。

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