游戏引擎 / 系统课时
查出对象数量不断增长
查出对象数量不断增长
战斗开始时运行流畅,玩上几分钟后却越来越卡,常见原因是子弹、特效或敌人节点不断创建而没有正常退出。本课用 Cocos Creator 3.8 的运行时计数、分支隔离和生命周期核对,找出究竟是哪一类对象在累积。
学习目标
- 在固定操作下记录节点数量与增长趋势。
- 从场景分支定位重复创建或未回收的对象。
- 区分节点销毁、停用、脱离父节点和对象池复用,并完成回归验证。
先把增长现象复现出来
先固定测试动作:进入同一关卡,连续射击或刷怪 30 秒,停止操作再观察 30 秒;重复两轮。记录开始、操作中、停止后的节点数,并确认是否始终在同一场景。只有数量持续抬高、停止后不回落或无法稳定在合理上限时,才值得沿创建链排查。
不要只凭编辑器的静态层级判断运行时对象数量。动态调用 instantiate() 创建的子弹和伤害数字,可能在预览中大量出现;它们应该被挂到明确的容器,例如 Bullets、Enemies、Effects,这样能够按分支计数,而不必在整个场景里盲查。
用运行时脚本定位增长分支
在项目的 assets/scripts 下新建 NodeCountProbe.ts,保存以下完整组件;将其挂到始终激活的诊断节点,再把想检查的 Bullets 等容器拖到 watchRoot。不设置该属性时,默认只统计组件所在节点及其后代。
import { _decorator, Component, Node } from 'cc';
const { ccclass, property } = _decorator;
@ccclass('NodeCountProbe')
export class NodeCountProbe extends Component {
@property({ type: Node })
watchRoot: Node | null = null;
private previous: number | null = null;
private countTree(node: Node): number {
// 连未激活的后代也统计,根节点本身算一个。
let count = 1;
for (const child of node.children) {
count += this.countTree(child);
}
return count;
}
private report(): void {
const root = this.watchRoot ?? this.node;
const count = this.countTree(root);
const delta = this.previous === null ? 0 : count - this.previous;
console.log(`[NodeCount] ${root.name} count=${count} delta=${delta}`);
this.previous = count;
}
start(): void {
this.report();
// 每两秒采样一次,不在每一帧递归遍历场景。
this.schedule(() => this.report(), 2);
}
}预期输出(浏览器预览的控制台中每隔约两秒更新,名称和数量随场景而变):
[NodeCount] <ROOT_NAME> count=<COUNT> delta=0
[NodeCount] <ROOT_NAME> count=<COUNT> delta=<DELTA>count 是被监视子树中的节点总数,delta 是两次采样之差;首次采样的差值固定为零。轮流监视 Bullets、Effects 和 Enemies,比较同样操作时哪一支持续正增长。若暂停发射后 Bullets 仍不减少,就检查该分支的回收逻辑;若只有短暂峰值后恢复,则未必存在泄漏。

沿创建与退出路径寻找根因
在增长分支中搜索 instantiate()、new Node() 及其调用位置,再核对每一种退出条件。子弹命中后是否回收?飞出边界后是否处理?场景切换后,延迟回调是否还会新建特效?某个组件是否在每次启用时重复注册定时器或事件监听,却没有在停用或销毁时取消?
要特别分清四种行为:
node.active = false:停止激活相关逻辑,但节点仍留在树中。node.removeFromParent():解除父子关系,不等于销毁;若还有引用,对象仍可能存在。node.destroy():发起销毁,实际清理在当前帧稍后完成,不要在同一帧立刻据此判定计数失败。- 对象池回收:节点可能离开场景树并被池持有,池内对象应有明确容量上限和再次复用路径。
因此,场景节点计数不是内存泄漏判定器:脱离场景的池对象、业务数组和事件闭包所持有的引用,无法由这段树遍历直接发现。遇到树计数稳定但内存持续增长,应继续检查对象池容量、长期数组和浏览器内存快照。销毁时序可参考 Cocos Creator 3.8 Node API。
修复后进行等条件回归
优先补齐子弹命中、超时、越界和场景退出时的统一回收入口;对于高频对象,使用有上限的对象池,取得时重置状态,归还时取消计时器与监听。修复时不要仅通过隐藏节点掩盖数量增长。
再次按原先的射击时长和操作顺序测试,观察增长分支是否在停止生成后回到基线或稳定平台;再切换场景并重复进入,确认旧对象不会累积。最后移除临时计数组件,避免诊断遍历和日志留在正式版本中。