CHUAN2 DEV ENGINE
996 正版授权研发中心 · 360 授权合作教学中心 · 抖音传奇直播合作授权 · 快手推广运营商授权
OFFICIAL LICENSED ACADEMY 查验官方授权证书 →
// 威海旷世互娱教学基地 · 技术文章
框架设计模块生命周期

【框架设计】模块生命周期钩子:加载顺序与卸载的统一管理** <!--TAGS: 框架设计,模块,生命周期

2026-09-23 16:58 作者:996 技术组 996引擎Lua教程传奇脚本

实战应用:用在哪里

红名、师门、行会、邮件十几个模块互相调用,加载顺序错了就是一串 nil 报错,热更新卸载不干净就是状态残留。生命周期框架给每个模块声明依赖与四个钩子,加载、卸载、启停全部走统一入口。

模块的依赖声明与排序

模块表声明依赖名单,框架按依赖做拓扑排序,被依赖者先加载,环状依赖直接报错拒绝。

lua
local MODULES = {
    { name = "var",    deps = {} },
    { name = "guild",  deps = { "var" } },
    { name = "redname", deps = { "var", "guild" } },
    { name = "mentor", deps = { "var" } },
}
local function topoSort()
    local sorted, done = {}, {}
    local function visit(m)
        if done[m.name] then return end
        for _, d in ipairs(m.deps) do
            visit(MODULES[d] or error("unknown module:" .. d))
        end
        done[m.name] = true
        sorted[#sorted + 1] = m
    end
    for _, m in ipairs(MODULES) do visit(m) end
    return sorted
end

四钩子的启停执行

每个模块实现 load、start、stop、unload 四钩子,框架按排序执行,任一环节失败回滚已启动模块。

lua
function bootAll()
    local ok, err = pcall(function()
        for _, m in ipairs(topoSort()) do
            m.load and m.load()
            m.start and m.start()
        end
    end)
    if not ok then
        setsysvar("BOOT_ERR", tostring(err))
    end
end

验证与监控

测试环境模拟依赖环与缺失模块,框架必须拒启并给出可读错误。上线后统计启动耗时与各模块占比,单模块加载超过五百毫秒纳入慢载清单治理。

踩坑记录

sendluamsg首参要求玩家对象,拿nil当日志出口会在启动期抛错,启动失败信息走setsysvar落盘,服务起来后再读出分析。拓扑排序的visit递归在模块数十个以内无栈风险,超过百个改迭代写法。钩子里的业务初始化别做重IO,启动时间的敌人是一次性的全量读盘,懒加载到首次使用再读。热更新的unload要清理定时器与全局表引用,只替换函数不清状态,新代码读旧状态是热更事故的经典形态。\
\

作者履历与出处

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

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

幂尔框架 · 实战干货 · 接口调用

LATEST ARTICLES

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

引擎触发沃玛祭坛祭品召唤

【引擎触发】沃玛祭坛:祭品投放的召唤触发设计

实战应用:用在哪里 沃玛祭坛是沃玛森林深处的隐藏玩法:玩家投放指定祭品积累召唤进度,进度满格召唤出沃玛教主之影,全服玩家都可…

2026-09-23 20:13 996 技术组
玩法策划魔军压境前哨预警

【玩法策划】魔军压境前哨:入侵事件的预警哨塔设计

实战应用:用在哪里 全服入侵事件最大的问题是玩家总是在事后才知道。魔军压境前哨把预警做成玩法的一部分:入侵前三哨塔依次亮起,…

2026-09-23 20:13 996 技术组
后端接口坐骑喂养加成

【后端接口】坐骑喂养:坐骑饱食度与加成接口

实战应用:用在哪里 坐骑不喂会饿、喂饱了跑得快,饱食度是坐骑系统的核心状态。坐骑喂养接口管理饱食度的增减与加成联动:饱食度一…

2026-09-23 20:13 996 技术组
前端接口宠物合成分解预览

【前端接口】宠物合成分解页:材料消耗的预览

实战应用:用在哪里 宠物合成要消耗材料与金币,分解返还多少材料,玩家在操作前就该知道。宠物合成分解页把合成消耗、分解返还、成…

2026-09-23 20:13 996 技术组
数据存储异库备份分离订单

【数据存储】异库备份:角色与订单的分离备份

实战应用:用在哪里 角色数据与订单数据曾共用一套备份,订单回滚时把角色也卷了回去,玩家充了钱角色却回到三天前。异库备份把角色…

2026-09-23 20:13 996 技术组
玩法策划师门切磋周切磋积分赛

【玩法策划】师门切磋周:门内切磋的积分赛设计

实战应用:用在哪里 师门成员平日各忙各的,同门之间几乎零交流。师门切磋周把门内切磋变成积分赛:一周内师门成员互相发起切磋,胜…

2026-09-23 20:13 996 技术组