游戏引擎 / 系统课时
沿引用链定位未释放对象
沿引用链定位未释放对象
场景已经卸载,纹理、材质或脚本对象却仍出现在内存快照中,通常需要检查谁还持有它们。本课使用 Unity 6 Memory Profiler 的引用分析功能,从未释放对象反向追踪到持有者,修复错误引用,并通过前后快照确认资源是否真正释放。
学习目标
- 使用 Referenced By 追踪对象引用关系,区分直接引用和根引用。
- 识别静态字段、事件订阅、常驻对象等导致资源无法释放的原因。
- 通过可复现的静态缓存案例,验证解除引用与资源卸载的效果。
从内存快照定位可疑对象
假设玩家离开关卡后,一张只用于该关卡的纹理仍然占用内存。此时不能直接认定发生泄漏,因为纹理可能被其他场景共享,也可能被有意保留在缓存中。需要先确认资源确实存在,再检查持有关系。
在 Unity 6 中按照以下步骤操作:
- 打开
Window > Package Manager,确认已安装Memory Profiler包。推荐使用兼容当前 Unity 版本的稳定版本。 - 打开
Window > Analysis > Memory Profiler,通过顶部目标选择器连接运行中的 Development Build Player。编辑器 Play Mode 也能调试,但其内存状态可能受到编辑器自身引用影响。 - 在目标关卡正常运行、资源加载完成后点击
Capture,保存快照 A。 - 离开目标关卡,等待场景卸载与业务清理操作结束,在受控测试中执行未使用资源卸载,再点击
Capture保存快照 B。 - 打开快照 B,进入
Unity Objects,使用搜索框查找目标资源名称,例如LevelBossTexture。展开Texture2D分类,选择对应的具体对象。
查看 Selection Details 中的 Size、Status 和引用信息。对于普通 C# 对象,可在 All Of Memory > Scripting Memory > Managed Objects 中继续检查对应类型。
沿反向引用链找到持有根
选中目标对象后,重点查看 Memory Profiler 的 References 区域。这里有两个容易混淆的方向:
Referenced By:哪些对象引用当前对象。定位无法释放的原因时,从这里开始。References To:当前对象引用了哪些其他对象。适合检查它向外持有的内容,但不能直接说明谁保留了它。
假设一个静态纹理缓存长期保存 Texture2D,逻辑上的持有链是静态字段引用托管包装对象,托管包装对象关联 Unity 原生纹理对象。即使原场景已经卸载,资源仍可能因为静态引用而保持可达。

实际排查时按以下顺序展开:
- 在
Referenced By中展开目标对象的直接引用者,记录对象类型与字段信息。 - 逐层检查上游引用,尤其留意静态字段、常驻单例、
DontDestroyOnLoad对象、事件委托和其他仍存活的场景对象。 - 结合
Selection Details > Managed Fields查找具体字段,例如cache、currentLevel或集合成员,定位到负责持有引用的代码。 - 如果有多条引用路径,逐条确认。只移除其中一条,其他强引用仍可能阻止资源释放。
在提供 Shortest Path To Root 功能的 Memory Profiler 1.1.11 等较新版本中,可以先使用该标签快速寻找一条根引用路径,再用 Referenced By 检查其他路径。最短路径视图不代表列出了所有持有者。
用静态缓存复现资源常驻
下面建立一个最小实验:将纹理加载到静态字段,在执行未使用资源卸载后检查其常驻状态;随后清空字段,再次请求卸载。
准备工作:
- 在项目中创建
Assets/Resources文件夹,放入一张纹理,命名为LeakDemoIcon.png,导入类型使用Default。 - 新建 C# 脚本
TextureHoldDemo.cs,将以下完整代码放入其中。 - 创建空
GameObject,挂载TextureHoldDemo组件。运行场景后,屏幕左上角会出现两个测试按钮。
using System.Collections;
using UnityEngine;
public sealed class TextureHoldDemo : MonoBehaviour
{
private static Texture2D cache;
private bool busy;
private void OnGUI()
{
GUI.enabled = !busy;
if (GUI.Button(new Rect(20, 20, 260, 48), "A: Load"))
StartCoroutine(LoadTexture());
if (GUI.Button(new Rect(20, 78, 260, 48), "B: Release"))
StartCoroutine(ReleaseTexture());
GUI.enabled = true;
}
private IEnumerator LoadTexture()
{
busy = true;
// 静态字段跨越普通场景对象的生命周期持有资源
cache = Resources.Load<Texture2D>("LeakDemoIcon");
if (cache == null)
{
Debug.LogError("Missing Assets/Resources/LeakDemoIcon.png");
busy = false;
yield break;
}
yield return Resources.UnloadUnusedAssets();
Debug.Log("A: static reference retained");
busy = false;
}
private IEnumerator ReleaseTexture()
{
busy = true;
// 先断开持有关系,再请求卸载不再使用的资源
cache = null;
yield return Resources.UnloadUnusedAssets();
Debug.Log("B: reference cleared; unused assets unloaded");
busy = false;
}
}先点击 A: Load,等待日志出现,再通过 Memory Profiler 采集快照 A。然后点击 B: Release,等待完成后采集快照 B。
预期输出(依次点击两个按钮,成功加载资源时):
A: static reference retained
B: reference cleared; unused assets unloaded这两条日志只证明测试代码执行到了相应阶段,并不直接证明纹理已经从内存消失。真正的验证应查看快照:A 中能够找到 LeakDemoIcon,B 中该纹理应不再作为已加载的原生资源出现,前提是没有其他对象引用它。
实验中的 Resources.UnloadUnusedAssets() 返回 AsyncOperation,使用 yield return 等待操作完成。它会检查资源是否仍被场景层级、脚本组件和静态字段等引用,因此第一次卸载不会清除静态字段保留的纹理。
根据持有者选择修复方式
找到引用路径后,应修改负责持有资源的代码,而不是一发现内存占用就强制调用 GC.Collect()。不同根引用需要不同的清理策略。
| 持有来源 | 常见现象 | 正确处理 |
|---|---|---|
| 静态字段或静态集合 | 离开关卡后旧纹理仍在缓存 | 在缓存失效时移除条目或赋值 null |
| 静态事件 | 场景对象销毁后托管包装对象仍被委托持有 | 在 OnDisable 或对应生命周期解除订阅 |
DontDestroyOnLoad 对象 |
常驻管理器仍持有上一关资源 | 在关卡切换时清空已不需要的字段或集合 |
| Addressables 加载句柄 | 不再显示的资源仍被加载系统保留 | 按加载与实例化方式配对调用 Addressables.Release 或 Addressables.ReleaseInstance |
| 其他场景的组件字段 | 纹理被其他存活对象共享 | 确认全部使用者结束后再卸载 |
例如,场景中的敌人脚本订阅了静态事件,却未在合适的生命周期解除订阅,静态委托就可能持续持有该脚本实例。即使对应的 Unity 原生组件已经销毁,托管包装对象仍可能因为委托引用留在托管堆中。
对于通过 Addressables 加载的资源,仅把业务字段置空通常不够,还需要释放对应的加载句柄或实例。不能把 Resources.UnloadUnusedAssets() 当作 Addressables 引用计数管理的替代品。
通过两次快照验证修复
修复后,使用相同目标平台、相同加载操作和相同卸载时机重新取样。Memory Profiler 的 Compare Snapshots 可以比较对象数量及内存占用,但还应分别打开原始快照检查具体对象。
| 检查项目 | 修复前快照 A | 修复后快照 B |
|---|---|---|
| 目标纹理对象 | 仍存在 | 无其他引用时应消失 |
| 静态字段引用 | 指向纹理 | 已清空 |
| 反向引用路径 | 可追踪到异常持有者 | 异常路径已消失 |
| 整体内存占用 | 作为对照基线 | 可能下降,但不保证立即减少相同字节数 |
如果 B 中仍然存在目标对象,继续展开 Referenced By,检查是否有第二个缓存、尚未释放的加载句柄或其他存活场景对象。不要只根据对象名称判断同一性;必要时结合类型、实例信息和具体引用字段区分同名对象。
还需区分对象释放和内存保留:Unity 的托管堆、原生分配器及系统可能保留已经空闲的内存供后续复用,所以系统常驻内存没有立即下降,不代表目标资源一定仍被引用。反过来,内存总量下降也不能替代对象级引用检查。
最终应以目标资源是否仍存在、异常根引用是否消失、重复加载与卸载后对象数量是否持续增长作为验收依据。对需要跨关卡复用的正常缓存,应记录其预期生命周期,而不是误判为泄漏。