游戏引擎 / 系统课时

查出场景切换后的内存增长

查出场景切换后的内存增长

从 Battle 返回 Lobby 后内存稍有上升,不一定表示发生泄漏:资源缓存、纹理上传和垃圾回收都会影响内存曲线。本课通过重复场景切换、比较稳定时刻的内存状态,检查常驻对象、动态资源与引用计数,并修正资源释放时机,让场景内存占用逐渐趋于稳定。

学习目标

  • 建立可重复的场景切换测试,区分正常缓存增长与持续残留。
  • 根据 JS 堆快照和资源引用关系定位节点、事件订阅及动态资源问题。
  • 正确管理动态加载资源的生命周期,并验证场景退出后的清理行为。

先建立可比较的内存基线

内存问题必须在相同状态下比较。不能把刚进入 Battle、正在加载纹理的瞬间,与返回 Lobby 很久后的状态直接对比,因为这两个时刻使用的资源、节点和缓存都不相同。

以 Lobby 和 Battle 两个场景为例,建立固定测试过程:

  1. 启动游戏进入 Lobby,先执行一次 Lobby → Battle → Lobby 的完整切换,让必要的缓存完成首次加载。
  2. 返回 Lobby 后等待场景稳定,在 Chrome DevTools 的 Memory 面板中选择 Heap snapshot,创建初始快照,记为 S0。
  3. 再执行一次 Lobby → Battle → Lobby,等待相同的稳定时间,创建 S1。继续重复,获得 S2、S3 等快照。
  4. 对比这些快照中的 JS 堆对象数量、保留大小与引用路径,重点查看旧场景相关节点、组件及闭包是否持续累积。

进行快照比较时,必须区分 Allocated Size 和 Retained Size。前者描述对象自身分配的内存,后者有助于判断这个对象及其引用关系可能阻止多少内存被回收。若旧场景对象持续出现在后续快照中,应沿 Retainers 路径寻找仍在持有它的对象。

Chrome 的 JS 堆快照主要反映 JavaScript 对象,不能直接等同于进程总内存或 GPU 显存。纹理、网格缓冲和原生引擎分配需要结合目标平台的性能分析工具检查。也不能仅凭操作系统显示的进程占用没有立即下降,就认定资源仍然被业务代码引用。

判断增长属于哪一种情况

观察内存曲线时,优先区分首次加载后的正常缓存增长、JavaScript 对象残留和底层图形资源未释放。

观察到的现象 可能原因 下一步检查
第一轮内存上升,后续趋于稳定 资源缓存、运行时初始化 延长测试轮次,确认是否达到平台可接受的稳定水平
每轮都留下更多旧场景对象 全局引用、事件监听或异步回调残留 检查 Heap snapshot 的 Retainers 路径
JS 堆相对稳定,但纹理或原生内存继续增长 资源引用未释放、动态纹理或底层资源残留 检查资源加载和释放配对情况,结合原生或图形分析工具

如果每次回到 Lobby 后,旧 Battle 组件数量持续增加,就不能简单归因于正常缓存。应检查常驻管理器、全局数组、事件总线、定时任务及异步回调是否仍然引用已经离开的场景对象。

场景销毁与资源释放不是一回事

在 Cocos Creator 3.8 中,切换场景会销毁不属于常驻体系的旧场景节点,但节点被销毁并不表示所有相关资源立即从内存和显存中消失。

需要分别处理两种对象:

  • 场景节点和组件:主要通过节点层级的生命周期管理。旧场景销毁时,正常挂在场景内的节点及组件会随之销毁,但外部仍然持有的 JavaScript 引用和业务数据可能继续存活。
  • Prefab、Texture、Mesh 等 Asset:由资源管理器维护加载缓存与引用计数。场景自动释放策略主要处理场景引用的资源,脚本动态加载的资源需要开发者额外关注其生命周期。

例如,某个常驻管理器将 Battle 节点保存到全局数组,场景退出后没有清除记录,可能导致旧的 JavaScript 对象仍被引用。另一个常见错误是动态加载 Prefab 后调用 addRef(),却从未在退出场景时配对执行 decRef(),使资源一直受到额外引用保护。

场景切换后节点销毁与资源引用释放的关系

正确的思路是为每份资源明确一个拥有者,记录它何时获取、由谁使用、何时归还。不要仅因为调用了 node.destroy(),就认为动态加载的所有资源已经完成释放;也不要在尚有其他场景使用资源时直接强制释放共享 Asset。

给动态加载的 Prefab 建立释放配对

下面用一个简单的 Battle 标记 Prefab 演示动态资源所有权。先创建 assets/resources/prefabs/BattleMarker.prefab,使其包含可见的模型或标记节点,然后将脚本挂到 Battle 场景中的普通非持久化节点。

创建 assets/scripts/BattleMarkerOwner.ts。组件成功加载资源后增加一次引用,退出场景时减少同一份引用;如果异步加载完成时所属节点已经被销毁,也立即归还刚刚取得的引用,避免场景退出与加载回调发生竞态。

ts
import {
    _decorator, Component, Node, Prefab,
    instantiate, isValid, resources
} from 'cc';

const { ccclass } = _decorator;

@ccclass('BattleMarkerOwner')
export class BattleMarkerOwner extends Component {
    private _prefab: Prefab | null = null;
    private _instance: Node | null = null;

    start(): void {
        resources.load('prefabs/BattleMarker', Prefab, (err, prefab) => {
            if (err) {
                console.error('BattleMarker 加载失败', err);
                return;
            }

            // 组件负责持有这份资源引用,退出时必须配对归还
            prefab.addRef();

            if (!isValid(this.node, true)) {
                // 异步加载结束时场景可能已经销毁
                prefab.decRef();
                return;
            }

            this._prefab = prefab;
            const instance = instantiate(prefab);
            this.node.addChild(instance);
            this._instance = instance;
            console.log('BattleMarker 已创建');
        });
    }

    onDestroy(): void {
        // 子节点随场景层级销毁,这里清理业务持有的引用
        this._instance = null;
        if (this._prefab) {
            this._prefab.decRef();
            this._prefab = null;
        }
        console.log('BattleMarkerOwner 已清理引用');
    }
}

预期输出:在资源成功加载、正常进入 Battle 并随后离开该场景的情况下,控制台依次出现:

text
BattleMarker 已创建
BattleMarkerOwner 已清理引用

如果场景在资源完成加载之前就被销毁,可能只看到清理引用的日志,而不会创建实例。这个分支是预期行为,因为回调中的有效性检查阻止了对已销毁场景继续添加节点。

这段代码依赖 Cocos Creator 3.8 运行环境与上述 Prefab 资源。addRef() 和 decRef() 管理的是当前组件明确持有的资源引用;执行 decRef() 后,引擎会根据引用计数和释放规则尝试回收资源,并不意味着 GPU 显存会在日志输出的瞬间同步下降。

检查场景自动释放与常驻对象

除了脚本动态加载的资源,还要检查 Battle 场景本身的自动释放策略。在 Cocos Creator 3.8 编辑器中双击打开 Battle 场景,选中层级管理器中的 Scene 根节点,再到属性检查器查看场景的自动释放资源设置。

Cocos Creator 3.8 场景根节点自动释放资源设置位置

如果 Battle 的静态依赖资源退出后已不再使用,可以启用场景自动释放。但自动释放不能代替动态资源管理;对于需要跨场景继续使用的共享资源,还必须确保其引用关系正确,避免在切换时过早释放。

常驻节点还需要单独检查。使用 director.addPersistRootNode() 保留的节点不会随着普通场景切换自动销毁,适合承载跨场景必需的管理器,但不应无限持有旧场景对象。退出业务场景时,相关事件订阅、异步请求回调和旧节点引用都应完成清理。

验证内存是否进入稳定状态

完成修改后,重新执行最初的 Lobby → Battle → Lobby 循环,并在同样的稳定时刻采集快照。不要要求内存每次都精确回到启动时的数值,因为引擎、浏览器和资源缓存可能继续保留可复用的内存。

验收时主要检查以下事实:

  • 后续多轮切换中的 JS 堆占用逐渐稳定,不再出现持续累积的 Battle 对象。
  • 通过 Retainers 路径检查,不再由常驻管理器或事件回调保留已经无用的旧场景对象。
  • 动态资源的获取与释放能够配对,场景退出后不再需要的资源没有被额外引用长期占用。
  • 在目标平台上观察纹理和原生内存,确认不会随着切场景次数持续无界增长,同时重新进入 Battle 时显示与交互仍然正常。

如果 JavaScript 堆已经稳定,但目标设备仍然持续增长内存,应进一步调查动态纹理、渲染缓冲以及原生资源生命周期,而不是继续盲目清空普通数组。

场景切换内存排查的最终目标不是让每一次切换都触发最大规模的垃圾回收,而是保证业务对象能按生命周期退出、共享资源有明确的持有者,并让整体内存在多次往返后达到可预期的稳定水平。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

查出场景切换后的内存增长

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通