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

完整课程入口：996 全套课程体系 ｜ Lua 学习路径 ｜ 幂尔框架 mirs.cn

等玩家截图就晚了

玩家遇到脚本报错，九成选择沉默退出，剩下一成给你发的截图往往只有半行错误。远程日志上报的目标是：客户端与服务端的 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 的处理时间缩短一个量级——这就是工程上的复利。

上报接口

senddiymsg(play, jsonStr)

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

拼装 json

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 亿。

分级落盘

addtextlist(path, str, line)

写入指定文本文件，line 取 0 到 65535 的行号。ERROR 立即落盘，WARN 按小时聚合。

release_print(msg)

打印任意类型内容到控制台，仅开发环境使用。

错误串去重

checkcontainstextlist(path, str, model, result)

model 取 0 判断列表里是否已包含该字符串，可用来确认某个错误串此前是否已经上报过。