游戏引擎 / 系统课时

沿引用链定位未释放对象

沿引用链定位未释放对象

场景已经卸载,纹理、材质或脚本对象却仍出现在内存快照中,通常需要检查谁还持有它们。本课使用 Unity 6 Memory Profiler 的引用分析功能,从未释放对象反向追踪到持有者,修复错误引用,并通过前后快照确认资源是否真正释放。

学习目标

  • 使用 Referenced By 追踪对象引用关系,区分直接引用和根引用。
  • 识别静态字段、事件订阅、常驻对象等导致资源无法释放的原因。
  • 通过可复现的静态缓存案例,验证解除引用与资源卸载的效果。

从内存快照定位可疑对象

假设玩家离开关卡后,一张只用于该关卡的纹理仍然占用内存。此时不能直接认定发生泄漏,因为纹理可能被其他场景共享,也可能被有意保留在缓存中。需要先确认资源确实存在,再检查持有关系。

在 Unity 6 中按照以下步骤操作:

  1. 打开 Window > Package Manager,确认已安装 Memory Profiler 包。推荐使用兼容当前 Unity 版本的稳定版本。
  2. 打开 Window > Analysis > Memory Profiler,通过顶部目标选择器连接运行中的 Development Build Player。编辑器 Play Mode 也能调试,但其内存状态可能受到编辑器自身引用影响。
  3. 在目标关卡正常运行、资源加载完成后点击 Capture,保存快照 A。
  4. 离开目标关卡,等待场景卸载与业务清理操作结束,在受控测试中执行未使用资源卸载,再点击 Capture 保存快照 B。
  5. 打开快照 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 原生纹理对象。即使原场景已经卸载,资源仍可能因为静态引用而保持可达。

静态字段通过托管包装对象持有原生纹理,以及解除引用前后的关系

实际排查时按以下顺序展开:

  1. 在 Referenced By 中展开目标对象的直接引用者,记录对象类型与字段信息。
  2. 逐层检查上游引用,尤其留意静态字段、常驻单例、DontDestroyOnLoad 对象、事件委托和其他仍存活的场景对象。
  3. 结合 Selection Details > Managed Fields 查找具体字段,例如 cache、currentLevel 或集合成员,定位到负责持有引用的代码。
  4. 如果有多条引用路径,逐条确认。只移除其中一条,其他强引用仍可能阻止资源释放。

在提供 Shortest Path To Root 功能的 Memory Profiler 1.1.11 等较新版本中,可以先使用该标签快速寻找一条根引用路径,再用 Referenced By 检查其他路径。最短路径视图不代表列出了所有持有者。

用静态缓存复现资源常驻

下面建立一个最小实验:将纹理加载到静态字段,在执行未使用资源卸载后检查其常驻状态;随后清空字段,再次请求卸载。

准备工作:

  1. 在项目中创建 Assets/Resources 文件夹,放入一张纹理,命名为 LeakDemoIcon.png,导入类型使用 Default。
  2. 新建 C# 脚本 TextureHoldDemo.cs,将以下完整代码放入其中。
  3. 创建空 GameObject,挂载 TextureHoldDemo 组件。运行场景后,屏幕左上角会出现两个测试按钮。
csharp
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。

预期输出(依次点击两个按钮,成功加载资源时):

text
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 的托管堆、原生分配器及系统可能保留已经空闲的内存供后续复用,所以系统常驻内存没有立即下降,不代表目标资源一定仍被引用。反过来,内存总量下降也不能替代对象级引用检查。

最终应以目标资源是否仍存在、异常根引用是否消失、重复加载与卸载后对象数量是否持续增长作为验收依据。对需要跨关卡复用的正常缓存,应记录其预期生命周期,而不是误判为泄漏。

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

目录与阅读设置

阅读设置

17

记录一个想法

沿引用链定位未释放对象

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

登录哪都通