【数据存储】日志分级落盘：按级别分文件与滚动清理的实现

实战应用：用在哪里

日志是排查问题的生命线，但混在单一文件里的日志会自我淹没：ERROR 被 INFO 刷走、单文件涨到 GB 级打不开。分级落盘方案：按级别分文件、按大小滚动、按保留期清理，三件事让日志体系长期可维护。适用于服务端 M2 日志、脚本运行日志、客户端错误上报。

分级写入器

local Log = { levels = { DEBUG = 1, INFO = 2, WARN = 3, ERROR = 4 }, minLevel = 2 }

function Log.write(level, msg)
    if Log.levels[level] < Log.minLevel then return end
    local line = ("%s|%s|%s\n"):format(os.date("%Y-%m-%d %H:%M:%S"), level, msg)
    local f = io.open("logs/" .. level:lower() .. ".log", "a")
    if f then f:write(line); f:close() end
end

Log.write("ERROR", "背包写入失败 id=" .. tostring(playerId))

ERROR/WARN/INFO 各自独立文件，DEBUG 按需开启（minLevel 控制）。关键业务事件可以同时写两个文件（业务流水 + 级别文件）。

滚动与清理

单文件超过 50MB 滚动为带序号的归档文件（error.log → error.1.log），归档超过保留数量删除最旧的。清理策略按级别差异化：ERROR 保留 30 天（纠纷追溯周期）、INFO 保留 7 天、DEBUG 保留 1 天。清理脚本放定时任务每日执行，同时输出清理统计（删了几个文件、释放多少空间）进日报。

格式与查询

每行固定三段式（时间戳 | 级别 | 内容），内容内部再用竖线分隔字段。固定格式让命令行工具可以直接 grep 分析：grep ERROR error.log | grep 背包 一步筛出目标。高频写盘的注意点：Lua 侧用内存缓冲攒行，缓冲满 64KB 或每 5 秒落盘一次，写频率从每条一次降为批量一次。分级落盘配上固定格式，日志系统就从"存了再看"变成"随时可查"的可用基础设施。

ERROR 日志的写入要带随机延迟打散（同批次错误加 0 到 500 毫秒抖动），防止同一故障在千人社群同时触发时写爆磁盘。抖动不影响排查，只影响写入时序。

级别的使用约定

ERROR 用于需要人工介入的异常（写入失败、接口异常），WARN 用于已自动恢复的偏差（参数被纠正、重试成功），INFO 记录关键节点（登录、结算、配置重载）。三档定义写进团队文档并全员遵守，级别混用的日志文件会失去分级的意义。

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