【调试实战】日志回放还原：消息流录制与玩家操作复盘

实战应用：用在哪里

"我的东西没了""BOSS 掉落我明明第一个到"——这类纠纷与偶现问题，靠记忆和截图无法还原。日志回放把玩家会话期间的关键消息流（收发包、状态变更、触发执行）录制下来，事后按时间轴重放，完整还原操作序列。适用于：资产纠纷、外挂判定、偶现 bug 的现场还原。

录制设计：只录关键面

全量录制成本高且噪声大，录制面收敛为四类：收发的协议消息（命令号 + 关键字段）、资产变更（增减前后值 + 来源）、状态切换（地图进出、任务阶段）、Lua 错误（含栈）。每条记录带单调递增序号与毫秒时间戳：

local function record(kind, data)
    seq = seq + 1
    local line = ("%d|%d|%s|%s"):format(seq, nowMs(), kind, jsonEncode(data))
    appendBuffer(line)
end

写盘策略参考远程日志篇：内存缓冲 + 周期落盘 + 压缩归档。单个会话的录制文件控制在几 MB 内，超出按滚动文件切割。

回放实现：状态机逐条驱动

回放器按序号逐条读取记录，把每条消息重新喂给（隔离的）业务处理函数，输出"每一步之后的系统状态"。两种用法：对账模式——重放后对比最终状态与实际状态，差异点即问题所在；单步模式——在指定序号暂停，检查中间状态。隔离要求：回放环境使用独立的 world 实例与假时钟（时间戳来自录制数据而非当前时间），保证可重复。

治理价值：从争议终结器到功能回放器

纠纷判定：录制流是客观证据，掉落归属、交易顺序一目了然，客服沟通成本骤降。外挂判定：回放里能看到正常人不可能产生的操作序列（零间隔连点、越图移动）。更进一步，录制流可以做成"测试素材"——真实玩家的操作序列脱敏后成为回归测试的输入，覆盖手工构造不出来的场景。录制成本控制在每会话每日 1MB 以内，四类关键面全录也不构成 I/O 压力，这笔投入换来的是所有争议的终局答案。

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