【案例复盘】跳转地图白屏事故：预加载缺失的白屏三十秒复盘

实战应用：用在哪里

新地图混沌石窟开放当天，跳转进去的玩家集体白屏三十秒，世界频道刷屏“游戏坏了”。复盘发现新地图资源没进预加载清单，首次跳转边下边渲，把一次活动事故变成了加载机制的补课。

事故的还原

跳转接口直接mapmove，资源加载全靠客户端现场拉取，新地图资源包二十兆，弱网玩家三十秒白屏。

function enterChaosV1(actor)
    local player = class(actor)
    mapmove(actor, "hundun", 0, 0)
    sendmsg(actor, 0, "欢迎来到混沌石窟！")
end

活动公告发了，玩家涌进来，资源却没先行，欢迎语成了白屏前的收尾一条消息。

预加载清单的补丁

补丁把地图资源清单接入预加载：活动开启前六小时向在线玩家推送资源预下载，跳转前校验资源就绪，未就绪给进度条而非白屏。

function enterChaosV2(actor)
    local player = class(actor)
    local ready = tonumber(getplayvar(actor, 2, "CHAOS_READY") or "0")
    if ready ~= 1 then
        sendmsg(actor, 0, "地图资源加载中，完成后自动传送")
        setsysvar("CHAOS_WAIT", 1)
        return
    end
    mapmove(actor, "hundun", 0, 0)
end

验证与监控

预下载覆盖率、跳转白屏时长、弱网首开时长三项进发布检查单；每次新地图上线必跑弱网三十秒白屏验证。上线后白屏投诉归零，预下载覆盖率百分之九十八，漏掉的百分之二走就绪校验兜底。

踩坑记录

预下载的推送对象是当时在线玩家，推送后才上线的玩家不在名单里，就绪校验兜底的路径是这批玩家的唯一出路。CHAOS_READY标记要跟资源版本号绑定，资源热更后旧标记失效，版本号不校验就是白屏换汤不换药。SL_UNTIL_READY这类全局等待变量在界面重建后要重新挂载。欢迎语挪到资源就绪之后发，白屏前发的欢迎语是事故截图里最讽刺的一行。