内存所有权、异步加载与释放
适用:Cocos Creator 3.8.8 + TypeScript,资源所有权原理通用。资料核查:2026-11-17。官方资源文档按 3.8 LTS 维护;本节代码为教学示例,未在编辑器或微信真机执行。
把内存分层看,才知道释放了什么
游戏内存至少涉及 JavaScript 对象、引擎资源缓存、图片解码数据、纹理与缓冲、音频、字体、平台运行时等来源。JS 堆下降不代表 GPU 资源已经回收;磁盘缓存删除不代表当前纹理消失;节点销毁也不等于所有动态资源和事件监听解除。遇到“内存没降”,先说明测量的是哪一层,再讨论谁应该释放。
一个关卡结束时,旧地图、大图集、音频与对象池可能仍被全局管理器引用。新关卡开始加载后,新旧资源同时存在,峰值比任一稳态都高。切关流程应有明确交接:停止旧输入与任务,解除旧监听,销毁或回收视图,归还动态资源所有权,再推进新内容。若为了无缝过渡保留旧画面,需要把这段双份占用纳入预算。
JavaScript 引用与引擎引用不是一回事
Cocos 的静态资源引用可由序列化数据分析,运行时动态加载并长期持有的资源则需要开发者管理。把 SpriteFrame 赋给一个 JavaScript 字段,不会自动表达完整的引擎资源生命周期。官方提供 addRef/decRef 等机制,使用时要让“谁持有、何时归还”成对出现,而不是在某个公共清理函数中猜测哪些资源已经不用。
import { Asset } from 'cc';
class AssetLease<T extends Asset> {
private value?: T;
constructor(asset: T) { this.value = asset.addRef() as T; }
get asset() {
if (!this.value) throw new Error('LEASE_RELEASED');
return this.value;
}
release() {
const asset = this.value;
if (!asset) return;
this.value = undefined;
asset.decRef();
}
}
示例表达一个所有者的一份引用,release 可重复调用,但它不替代项目全部资源管理。多个对象共享同一资源时,每个明确持有者应遵守同一约定。销毁视图前先解除资源使用,再归还持有;不能拿到资源后既不登记引用,又期待场景切换准确推断所有业务缓存。
强制释放必须知道共享关系
Cocos 的 release 系列与引用计数释放检查存在差异,不能把 releaseAsset 当作“引用为零才释放”的安全操作。强制释放仍被其他精灵使用的纹理,可能产生黑图或渲染错误。共享公共图集、全局 UI 和角色资源时尤其要谨慎。先确定唯一所有权或完整退出边界,再选择手动释放;常规动态持有更适合成对引用管理。
removeBundle 只移除 Bundle 管理项,并不自动释放其中已加载的所有资源。反过来,调用 releaseAll 也不意味着所有业务字段和监听已清空。分清资源对象、Bundle 索引与业务引用三个层次,才能避免“移除了包但内存仍高”与“清了包后别的页面黑图”两类相反问题。
异步回调要处理所有者已经离开
加载开始时界面仍存在,结束时它可能已被关闭、复用或切换到另一关。仅在回调里判断节点是否存在还不够:对象池中的节点可能存在,却已经代表另一个对象。用请求世代或绑定标识确认结果仍属于当前需求,过时结果不能覆盖新内容。加载无法取消时,也能取消其业务落地,并按正确所有权归还资源。
场景内同一头像位连续加载甲、乙图片,甲先发出后到达,就可能覆盖乙。给每次绑定递增序号,回调比对后再设置;离开时递增序号令未完成请求过时。不要因为过时就无条件强制 release 资源,它可能已被其他请求共享。加载协调器、引用租约和视图世代分别处理不同职责。
监听、计时器与池也是资源
全局事件总线持有组件函数,函数闭包又持有节点,节点即使离开场景也可能无法回收。为每个 on 对应 off,为每个定时器保留取消句柄,为每个异步操作定义结束条件。用统一的 disposer 列表能帮助成对清理,但不用因此建立大型生命周期框架;关键是所有者清晰、退出路径可重复执行。
对象池需要最大容量与清空时机。池中的对象依然占内存,回收只是停止活跃使用;无限池会把峰值负载永久留在内存。归还时重置速度、目标、事件、计时器、特效与资源绑定,取出时重新设置身份。池化收益应由分配与长帧数据证明,而不是把所有节点都预热进池。
用重复循环识别泄漏与缓存
选择“大厅 → 首关 → 战斗 → 大厅”的固定循环,记录每次回到同一稳定点的堆、资源数、节点数、监听数与纹理估算。合理缓存可能前几轮增长后稳定;持续线性增长更值得追查。强制 GC 可在支持的调试环境辅助比较,但正式运行无法依赖它,也不能保证 GPU 或平台内存同步下降。
堆快照比较增长对象及保留路径,找出谁还引用它;分配时间线帮助识别高频短命对象。浏览器工具只能覆盖对应运行环境,微信终止问题还需真机日志与平台内存证据。别因一个 Array 数量多就直接删除缓存,先判断其是否按设计保留、是否有上限以及能否重新构建。
预加载也需要有所有者
为了减少切关等待而预加载下一关,是用当前内存换未来延迟。预加载完成后谁持有资源、玩家改去别处时何时归还,都要明确。不要让预加载器把每个可能关卡都永久加入全局缓存;按有限预测窗口和缓存容量保留,命中率与峰值一起评估。如果总被取消,预加载本身可能是在浪费带宽和内存。
加载中与已持有的资源也不同。多个请求共享一个底层加载时,取消其中一个消费者不应取消其他合法使用;只有最后一个所有者退出,才进入可释放状态。小项目可以用简单的引用租约表达,不必立即实现复杂资源调度系统,但应保证重复释放、失败路径和迟到结果都有确定行为。
交给 AI 的任务与验收
可复制任务:“审查关卡动态加载的所有权,列出资源、监听、定时器、池与进行中请求的创建和清理者。修复头像请求乱序与切关迟到,采用世代检查和成对引用;禁止对共享资源无条件 releaseAll。增加固定切关循环的诊断计数。”
验收旧头像不覆盖新绑定;离开后不写失效节点;重复退出无重复 decRef;共享 UI 不黑图;循环后资源与监听进入可解释稳定区间。具体内存峰值须测量,不能用引用计数正确推断设备永不退出。
官方来源
- Cocos 3.8 资源释放:静态与动态引用、释放检查及强制释放差别。
- Cocos 3.8 Asset Bundle:移除 Bundle 与释放资源的区别。
- Chrome 内存问题诊断:堆快照、分配与保留引用分析;浏览器证据不能替代微信设备测量。