【数据存储】ini 文件的读写缓存：readinibycache 的策略

实战应用：用在哪里

readinibycache 与 writeinibycache 是 ini 文件读写的缓存版本：首次读取加载到内存缓存，后续读取走缓存不再触碰磁盘，写入时同步更新缓存与延迟落盘。缓存的策略让高频读写的 ini 配置不再成为 IO 瓶颈。

读取与缓存

---ini 的缓存读取
function readinibycache(actor, section, item)
    local key = actor:GetUserId() .. ":" .. section
    local cache = iniCache[key]
    if not cache then
        cache = readini(actor, section, item)
        iniCache[key] = cache
    end
    return cache[item]
end

首次读取从磁盘加载到内存缓存，后续读取走缓存。缓存的键按玩家加分区隔离，不同玩家的缓存互不干扰。缓存的上限按玩家数量控制，每个玩家的 ini 数据量小（几 KB），千人的总缓存在可接受范围。

写入与落盘

---ini 的缓存写入
function writeinibycache(actor, section, item, value)
    local key = actor:GetUserId() .. ":" .. section
    local cache = iniCache[key]
    if not cache then
        cache = readini(actor, section, item) or {}
        iniCache[key] = cache
    end
    cache[item] = value
    dirtyIni[key] = true
end

写入先更新内存缓存再标记脏，脏标记的落盘由定时任务批量执行，写入的 IO 压力被摊平。脏标记的落盘频率：每 30 秒批量刷一次，突然宕机最多丢 30 秒的写入，可接受的丢失窗口。ini 的缓存在玩家下线时主动刷盘并释放，长期在线的玩家定时刷盘防堆积。

验证与监控

ini 缓存的命中率与脏标记数量监控，命中率低于八成说明缓存策略需要调整。

踩坑记录

缓存的写入曾经没有同步磁盘文件，宕机后丢失了整批的写入，脏标记的定时落盘解决。ini 的并发写入曾经出现文件锁冲突，同一文件的写入加互斥锁后消除。

上线要点

ini 缓存的封装对业务层透明：业务的读写接口不变，底层自动走缓存。ini 文件的清理任务配合缓存的生命周期，下线玩家的缓存释放与磁盘同步。ini 的格式版本化：引擎升级后 ini 格式变化要有转换脚本，老档的 ini 数据不丢失。

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