游戏引擎 / 系统课时

查找对象持续增长

查找对象持续增长

本节处理一种更隐蔽的内存问题:重复进入界面、生成 Actor 或切换玩法后,UObject 数量持续上升,即使逻辑上对象已经不用了也不回落。你会先用垃圾回收区分“等待回收”与“仍被引用”,再沿引用链找到真正留住对象的长生命周期持有者。

学习目标

  • 用对象计数与 GC 前后对比确认是否存在持续存活
  • 通过引用链定位让对象无法回收的强引用
  • 修正缓存、根引用和长期持有者的生命周期设计

先确认增长能不能被 GC 回收

先设计一个可重复循环,例如“进入战斗→生成一批临时对象→退出战斗”,连续执行数次,并在每轮结束后观察同一类对象的数量。对象数量上涨本身不等于泄漏,因为 Unreal 的 UObject 可能只是尚未走到下一次垃圾回收。

把 <ClassName> 替换为项目中实际的 UObject 类名。先列出该类对象,再执行一次对象垃圾回收,最后重新列出:

text
obj list class="<ClassName>"
obj gc
obj list class="<ClassName>"

预期结果:

text
如果这些对象已经不可达,执行 obj gc 后数量应明显回落并接近稳定基线。
如果数量仍保持高位或每轮继续增加,说明需要进一步检查引用链或项目自己的对象池/缓存策略。
具体对象数取决于实际项目。

沿引用链找到谁在留住对象

当某个本应销毁的实例在 GC 后仍然存在,下一步不是继续猜,而是查看谁引用了它。先从 obj list 输出中取得真实对象路径,再把它代入 obj refs。

text
obj refs name="<ObjectPath>"

预期结果:

text
输出指向该对象的引用关系链。
实际链路中的对象名与层级取决于当前项目;重点查找通向长生命周期对象、Root、Subsystem、GameInstance 或持久缓存的路径。

引用链通常会把“现象对象”和“真正根因”分开。例如临时奖励对象没有自己泄漏,而是被某个常驻管理器的 UPROPERTY 数组一直保存;只销毁 Actor 或把局部变量设为空,并不会自动清掉这个更上层的强引用。

UObject 持续存活的引用链

检查最常见的长生命周期持有者

优先检查寿命明显长于目标对象的拥有者,包括 UGameInstance、各种 Subsystem、单例式管理器、持久关卡对象,以及跨场景存在的缓存。只要这些对象中的 UPROPERTY、TObjectPtr 或 TStrongObjectPtr 仍然指向目标,垃圾回收就不能把目标当成不可达对象。

还要检查显式根引用。代码调用 AddToRoot() 后,对象会被放入根集合;如果对应生命周期结束时没有执行 RemoveFromRoot(),它会持续存活。对于自定义 FGCObject,也要确认 AddReferencedObjects 没有把已经失效的业务对象继续报告给 GC。

下面是一个典型的“观察缓存不应该拥有对象”的修正方式。它是片段示例,需要放入实际 UObject/Subsystem 类中,并由业务代码负责添加和清理条目。

cpp
// 强缓存会参与 UObject 可达性,适合真正拥有对象的场景。
UPROPERTY()
TArray<TObjectPtr<UObject>> OwnedObjects;

// 观察列表不负责延长对象寿命。
TArray<TWeakObjectPtr<UObject>> ObservedObjects;

void ReleaseOwnedObjects()
{
    OwnedObjects.Reset();

    ObservedObjects.RemoveAll(
        [](const TWeakObjectPtr<UObject>& Item)
        {
            return !Item.IsValid();
        });
}

这段片段的生效行为是:OwnedObjects 中的对象在数组被清空前会被强引用;ObservedObjects 只是弱引用,不会因为“被观察”而要求目标继续存活。修改后重新执行前面的复现循环、obj gc 与 obj list,验证对象数量是否回到稳定基线。

区分泄漏、缓存和正常高水位

持续增长要看趋势,不看单个时刻。对象数量在前几轮增长后稳定,可能只是缓存预热或对象池达到容量;每轮操作后都增加且 GC 后不回落,才更像错误持有。若对象数稳定但总内存仍涨,还要转向资源内存、原生堆分配或 GPU 资源继续分析,不能只盯 UObject 数量。

修复后的验收标准应是:重复同一路径多轮后对象数量进入稳定区间,GC 后不再按轮次累积,并且引用链中不存在意外的长生命周期持有者。这样才能证明你修掉的是生命周期根因,而不是暂时压住了表面数字。

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

目录与阅读设置

阅读设置

17

记录一个想法

查找对象持续增长

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

登录哪都通