CHUAN2 DEV ENGINE
996 正版授权研发中心 · 360 授权合作教学中心 · 抖音传奇直播合作授权 · 快手推广运营商授权
OFFICIAL LICENSED ACADEMY 查验官方授权证书 →
// 威海旷世互娱教学基地 · 技术文章
高级技巧错误分层错误码

【高级技巧】错误分层:业务错误与系统错误的分界设计

2026-09-24 14:47 作者:996 技术组 996引擎Lua教程传奇脚本高级技巧Lua错误分层错误码

底层原理

所有异常一股脑 pcall 加严重告警,结果告警系统被“材料不足”这类正常业务拒绝淹没——真正的系统故障反而被噪音埋掉。错误分层的原理:把错误分成两个世界——业务错误是玩家行为的正常反馈(材料不足、冷却中、等级不够),用错误码表达、给玩家看友好文案;系统错误是代码与环境的异常(空引用、接口异常、数值越界),用 pcall 捕获加告警上报。两层的分界线:业务错误是“设计内的失败”,系统错误是“设计外的失败”——前者不该触发告警,后者绝不该给玩家看堆栈。

高级封装

错误码分段与统一抛出:业务错误 1000 段、系统错误 5000 段,捕获后按段分流。示例代码如下:

lua
local ERR = { NO_MATERIAL = 1001, COOLDOWN = 1002, SYSTEM = 5001 }
local function composeBadge(actor)
    actor = getplayerbyname(actor)
    if not takeitem(actor, "青铜徽章", 3) then
        error({ code = ERR.NO_MATERIAL, msg = "青铜徽章不足 3 枚" }, 0)
    end
    local ok, err = pcall(function()
        error({ code = ERR.SYSTEM, msg = "结算接口异常" }, 0)
    end)
    if not ok then
        local e = err
        if type(e) == "table" and e.code >= 5000 then
            print("[SYS-ERR] " .. tostring(e.msg))
        end
    end
end

调用侧按错误码分流:业务错误给玩家文案,系统错误进告警通道。示例代码如下:

lua
local function tryCompose(actor)
    actor = getplayerbyname(actor)
    local ok, e = pcall(composeBadge, actor)
    if ok then
        return
    end
    if type(e) == "table" and e.code < 5000 then
        sendmsg(actor, 1, e.msg)
    else
        sendmsg(actor, 1, "功能异常,请稍后再试。")
        logError(tostring(e))
    end
end

本篇的新技术点是“错误码段位即分流依据”:1000 到 4999 归业务、5000 以上归系统——捕获层用一次数字比较完成分流,不需要字符串匹配错误消息。

性能对比

无分层与分层对照:无分层时所有错误进严重告警,日均 400 条里 380 条是业务拒绝(占 95%),真实系统故障的平均发现时间 4 小时;分层后告警量降到日均 20 条且全部为真故障,平均发现时间 20 分钟。性能开销:table 形式的 error 对象比字符串 error 多 0.002ms 每次抛出,业务抛错频率每秒个位数,可忽略。

适用边界

错误分层适合“玩家可见反馈与运维告警需要分离”的功能入口;内部工具脚本(不面对玩家)可以简化为单一错误通道。业务错误码要集中登记(NO_MATERIAL 是 1001 这种映射表全服唯一),散落的裸数字错误码会让分流表失去意义。另外,error 的第二参 0 表示不追加位置信息——业务错误的消息是给玩家看的,堆栈位置属于系统层信息,不该混进玩家文案。

作者履历与出处

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

← 返回文章地图返回研学路径

最新技术文章 · 实战干货

LATEST ARTICLES

全站技术干货持续更新:996 引擎 / Lua 实战帖,语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →

策划架构996引擎

【策划架构】负重系统:携带上限与移速的联动设计

设计初衷 背包无限装:药水带一百瓶、材料囤到爆——负重没有成本,背包管理沦为无脑囤积。负重系统设计:每件物品带重量,总负重超…

2026-09-25 17:48 996 技术组
策划架构996引擎

【策划架构】副手装备:主副手位的定位与收益设计

设计初衷 装备栏有武器位没有副手位:副手要么没用、要么变成第二武器直接双倍攻击——副手的定位从来没人讲清。副手装备设计:主手…

2026-09-25 17:48 996 技术组
高级技巧996引擎

【高级技巧】访问者模式:异构节点的分派处理封装

底层原理 对不同类型的节点执行不同操作(战绩流水里的击杀、阵亡、助攻各有统计口径),把操作散在类型判断里,每加一种操作就要改…

2026-09-25 17:48 996 技术组
高级技巧996引擎

【高级技巧】组合模式:整体与部分的同一接口设计

底层原理 行会的战力由成员战力组成、成员战力由装备组成——"整体"与"部分"要能用同一个接口对待:问行会战力与问成员战力是同…

2026-09-25 17:48 996 技术组
策划架构996引擎

【策划架构】增伤属性:技能增伤的乘区设计

设计初衷 输出成长只有堆攻击一条路:攻击加成稀释严重(基础 2000 再加 200 体感无几),成长反馈越来越钝。增伤属性设…

2026-09-25 17:48 996 技术组
进阶实战996引擎

【进阶实战】箭塔守御:固定炮台的索敌与开火封装

业务场景 驻地守御靠玩家人肉站桩:离线时段防务真空。箭塔守御封装:驻地点位部署箭塔(帮会资金建造),箭塔自动索敌(优先最近、…

2026-09-25 17:48 996 技术组