【前端接口】前端消息总线：SL:RegisterLuaNetMsg 的注册模式

实战应用：用在哪里

服务器的每一条推送都要有前端的接收器：血条变化、聊天消息、队伍同步、邮件提醒——SL:RegisterLuaNetMsg 是前端消息的总入口。注册模式的设计要点是协议号的集中登记、处理器的高内聚与注销的成对性。

注册的模式

---消息处理器的集中注册
local Handlers = {}

Handlers["HP_SYNC"] = function(data)
    local d = SL:JsonDecode(data)
    if not d then return end
    GUI:Text_setString(UI.hpLabel, "HP " .. d.hp)
end

Handlers["MAIL_TIP"] = function(data)
    SL:ShowSystemTips("收到新邮件，请查收")
end

---统一注册：一处遍历全部挂载
for msgId, fn in pairs(Handlers) do
    SL:RegisterLuaNetMsg(msgId, fn)
end

注册的集中化让消息的接收入口一目了然：Handlers 表按协议号登记处理器，统一遍历注册——散落在各处的注册让排查「谁在处理这条消息」变成大海捞针。处理器的内聚原则：一个处理器只做一件事（更新血条、弹提示），跨界面的联动用事件的二级分发，处理器的职责单一让 Bug 的定位一步到位。

注销的成对性

---界面的生命周期：开启注册、关闭注销
function MailWin.open()
    MailWin.handler = function(data)
        local d = SL:JsonDecode(data)
        if d then MailWin.refresh(d) end
    end
    SL:RegisterLuaNetMsg("MAIL_SYNC", MailWin.handler)
    GUI:Win_Open(MailWin.win)
end

function MailWin.close()
    SL:UnRegisterLuaNetMsg("MAIL_SYNC", MailWin.handler)
    GUI:Win_Close(MailWin.win)
end

窗口级的消息注册必须与窗口的生命周期成对：开启时注册、关闭时注销——邮件界面关闭后处理器还活着，每次推送都在操作已销毁的控件，报错与泄漏双生。注销的接口 SL:UnRegisterLuaNetMsg 与注册对称，注册的引用要保存（匿名函数无法注销），成对性的纪律靠代码评审的检查。高频消息的处理成本要算：每秒推送的移动同步消息，处理器内禁止任何分配与查找——处理器的轻量是帧率的保镖。

验证与监控

注册表的自检：界面的开启与关闭后，注册的处理器数量前后一致；消息处理的耗时抽样，单条处理超 5 毫秒即优化。

踩坑记录

注销的接口曾经拼错（Unregister 的大小写），静默不生效，接口名的常量表收口。匿名函数的注册曾经无法注销，处理器的引用保存成为注册的强制要求。JsonDecode 的失败曾经没有守卫，坏数据让处理器抛错中断后续消息，每个处理器以解析校验开头。

上线要点

消息的协议号与处理器的映射进文档，前端接什么、后端发什么一一对应。处理器的错误统一捕获进前端的错误上报，静默的失败不积累。高频消息与低频消息的处理分级，移动同步类走无分配的快速路径。