【数据存储】背包存档的增量序列化与脏标记

实战应用：用在哪里

40 格背包加仓库加随身包裹，全量序列化一次要写数千字节：千人在线时每秒的存档写入把数据库压垮。增量序列化用脏标记只写变更的格子——捡一把裁决之杖只写 1 格，写入量从数千字节降到几十字节。

脏标记的记录

---背包格子的脏标记
function Bag.markDirty(actor, slot)
    actor.bagDirty = actor.bagDirty or {}
    actor.bagDirty[slot] = true
    actor.bagDirtyCount = (actor.bagDirtyCount or 0) + 1
end

---入包、移除、换位时打标记
function Bag.onItemChange(actor, slot)
    Bag.markDirty(actor, slot)
end

脏标记在物品变更的入口统一打点：addbag 入包、delbag 移除、拖拽换位、装备穿戴，全部汇聚到 markDirty 一个入口。标记用哈希集合存储，同一格的多次变更只记一次，计数器用于脏格数量统计。

增量的落盘

---只序列化脏格并合并写入
function Bag.flushDirty(actor)
    if not actor.bagDirty or actor.bagDirtyCount == 0 then
        return 0
    end
    local slots = {}
    for slot in pairs(actor.bagDirty) do
        slots[#slots + 1] = slot
        actor.bagDirty[slot] = nil
    end
    actor.bagDirtyCount = 0
    QF_SaveBagSlots(actor:GetUserId(), slots, os.time())
    return #slots
end

落盘时遍历脏标记集合，只序列化变更格的数据包，提交数据库成功后才清空标记——清标记的时机在确认之后，中途宕机的脏格下轮继续落盘，数据不丢。全量存档退化为兜底：每 30 分钟做一次全量快照，增量的补丁与快照按时间轴叠加还原任意时刻的背包。

验证与监控

脏格数量的分布监控与落盘延迟统计，单次落盘超过 20 毫秒即告警。

踩坑记录

清标记曾经放在提交数据库之前，落盘失败后标记已丢，下次不再写这格造成静默丢数据，改为提交成功后再清。换位的实现曾经是删旧格加新格，两个格子都脏，后来改为单格变更语义换位只脏一格，写入量再降一半。

上线要点

所有物品变更路径必须走 markDirty 入口，绕过入口的直接修改用代码评审卡住。增量包带版本号与校验和，乱序到达的包按版本号丢弃旧版。增量的密度监控：单玩家每分钟脏格超过 30 次通常是脚本行为，样本转风控。

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