【调试热更】远程日志上报：玩家报错你先知道

等玩家截图就晚了

玩家遇到脚本报错，九成选择沉默退出，剩下一成给你发的截图往往只有半行错误。远程日志上报的目标是：客户端与服务端的 Lua 异常在发生的当下，自动带着完整上下文送到你面前。这是线上质量体系里性价比最高的一环。

客户端侧：全局兜底 + 关键路径包抄

Lua 里兜底异常的标准姿势是 xpcall + debug.traceback。在界面入口、网络消息处理、定时器回调这三个异常高发区，把业务函数统一包进 SafeCall：出错时把"错误消息 + 完整调用栈 + 当前界面名 + 玩家等级职业 + 最近 20 条操作事件"打包上报。上下文比错误本身值钱——只有一行 attempt to index a nil value 的上报等于没报。

上报通道优先复用游戏既有 HTTP 接口：拼一个 JSON 字段（时间、玩家标识、错误串、栈、上下文），POST 到日志收集接口即可。注意两条纪律：上报本身要 pcall 包住（日志系统绝不能成为新的崩溃源）；同一错误做去重合并（按错误串 hash，5 分钟窗口内只报一次加计数），否则一次刷屏 bug 能把日志通道打爆。

服务端侧：分级落盘 + 关键事件必达

服务端日志走文件即可，但要分级别：ERROR（Lua 异常、接口调用失败）立即落盘并可推送 GM 频道；WARN（参数被纠正、重试成功）按小时聚合；DEBUG 仅开发环境开。格式统一为"时间 | 级别 | 玩家/对象 | 事件 | 关键参数"，字段固定才能用脚本批量分析。

关键业务事件（充值回调、交易、装备销毁）单独打一条"事件日志"，与普通运行日志分文件。所有涉及玩家资产的异常， ERROR 级别附带当时的完整参数快照。

让日志变成生产力

收集之后要能查：每天定时脚本统计 ERROR Top10、按错误串聚类看新增与复发；错误出现曲线对齐"最近一次热更时间"，能秒级定位"哪次改动引入的"。再把 Top 错误做成知识库条目（原因 + 处理方案），新同事遇到同名错误直接照方抓药。

一套完整的远程日志体系，一天可以搭出雏形（SafeCall + HTTP 上报 + 分级落盘），一周内迭代出聚类统计。它不会让 bug 变少，但会让每个 bug 的处理时间缩短一个量级——这就是工程上的复利。

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

senddiymsg(play, jsonStr)

日志上报接口，引擎 64_23.12.07 起提供。

tbl2jsonex(tbl)

把 table 转成 json 字符串，数字 key 会转成字符串 key。

local msg = tbl2jsonex({
  t = os.time(),
  err = errMsg,
  stack = traceback,
  scene = curScene
})
pcall(senddiymsg, play, msg)

logact(play, logAct, loginfo, nParam1…nParam5)

logAct 需大于等于 10000，后 5 个整数参数可空，单个上限 21 亿。

【框架设计】宠物进阶：进化材料链与形态切换

【框架设计】坐骑系统：碎片合成与品质保底

【网络通信】动作与表情：社交广播的轻量协议

【性能调优】延迟结算：非紧急任务的队列消化

【安全加密】数据脱敏：日志与取证导出的隐私处理

【界面UI】BUFF 图标栏：增益排列与剩余时间