【前端底层】gameStateLogin：登录状态机的流程管理

实战应用：用在哪里

解密源码里的 gamestates 目录是客户端的启动状态机：从 gameStateInit（初始化）到 gameStateLogin（登录）到 gameStateRole（选角）再到 gameStateWorld（进世界），每个状态是一个独立的 Lua 模块，状态的切换由状态机统一驱动。

状态机的结构

---登录状态的进入与退出（整理自 gameStateLogin.lua）
function gameStateLogin:onEnter(param)
    loadLoginUI()
    bindNetHandlers()
    SL:ShowSystemTips("欢迎来到玛法大陆")
end

function gameStateLogin:onExit()
    unloadLoginUI()
    unbindNetHandlers()
end

每个状态实现 onEnter 与 onExit 两个钩子：进入时加载该状态的界面与处理器，退出时对称地卸载。状态机的骨架保证任意时刻只有一个活跃状态，资源的使用边界清晰——登录界面的资源在进入选角状态时释放。

状态的切换

---状态切换的统一入口
function GameStateMachine.switch(newState, param)
    if current == newState then return end
    local curState = states[current]
    if curState and curState.canExit and not curState:canExit() then
        SL:ShowSystemTips("当前状态不可退出")
        return
    end
    if curState then curState:onExit() end
    current = newState
    states[newState]:onEnter(param)
end

切换的三段式：旧状态退出、状态指针切换、新状态进入，canExit 的否决权让关键操作（交易中不可切状态）有了实现的位置。状态机的调试：打印切换的历史链（从哪个状态、何时、切到哪），闪退前的状态切换记录是崩溃排查的坐标。

验证与监控

状态的切换耗时与异常次数监控，onEnter 的异常必须被捕获并降级，不能让玩家卡在黑屏。

踩坑记录

状态的网络处理器曾经互相污染：登录状态注册的消息处理器在进入世界后仍在响应，处理器的注册与注销严格配对后修复。状态机的 canExit 否决曾经没有提示原因，玩家不知道为什么点不动，否决时附带原因文案是基本的尊重。

上线要点

新增状态（如跨服战场状态）的四件套：状态模块、canExit 规则、资源清单、切换条件，照清单接入不会有遗漏。状态机的切换历史进崩溃上报的上下文，闪退时的状态是排查的第一线索。

状态机的切换历史进崩溃上报的上下文，闪退时的状态是排查的第一线索。登录状态的资源清单（界面、协议、音效）在退出时逐项核对释放，资源的对称管理让状态机长期运行的内存曲线平稳。

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