游戏引擎 / 系统课时

排查资源引用与加载泄漏

排查资源引用与加载泄漏

进入关卡几次后,内存持续上涨,不一定是资源本身太大,也可能是场景实例、加载句柄或静态引用没有释放。本课建立一套可重复的加载实验,借助 Unity Profiler 与 Memory Profiler 找到资源被谁持有,再验证释放是否真正生效。

学习目标

  • 区分正常缓存、内存峰值与持续保留的资源。
  • 根据快照中的对象数量和引用关系定位未释放的持有者。
  • 为加载句柄建立明确的释放时机,并用重复测试验收。

先让占用增长可以重现

先在目标设备运行 Development Build,并通过 Window > Analysis > Profiler 连接 Player。固定关卡、画质和操作路径,预热一次后记录内存基线;随后重复打开和关闭同一个道具面板十次,每次都等待加载、销毁与异步清理完成。不要把首次载入 Shader、纹理或对象池扩容计入稳态泄漏。

观察 Memory 模块中的纹理、材质、对象数量,以及已使用内存的变化趋势。若每轮关闭后相同类型对象数量仍阶梯式上升,才值得深入追查。GC Alloc 是某帧产生的托管分配量,并不等于泄漏;Reserved Memory 可能因分配器缓存而长期维持高位,也不能单独作为证据。

从快照反查谁还持有资源

通过 Package Manager 安装 Memory Profiler(若项目尚未安装),在稳定基线和多轮关闭后各采集一份快照。比较 Unity Objects、纹理与材质的数量和占用,选择没有消失的对象,进一步查看引用与关联对象。找到“谁仍需要它”,比反复执行垃圾回收更有效。

资源链可能从 UI 面板经过 Addressables 加载句柄指向纹理及依赖项,也可能被静态集合、事件订阅或场景对象留住。同一个地址多次 LoadAssetAsync 通常会复用已加载资源,但每次操作的引用计数仍需要对应释放;反之,Instantiate 确实会产生新的场景实例。

Addressables 加载句柄与资源引用计数的正常释放和遗漏分支

让句柄跟随持有者销毁

下面用一个 Addressables 纹理加载者示范所有权管理。先安装 Addressables,将一张 Texture2D 标记为 Addressable、地址设为 DemoIcon,把脚本挂到会随面板一起销毁的 GameObject。实际 Player 构建还需准备对应的 Addressables 内容。

csharp
using System.Collections;
using UnityEngine;
using UnityEngine.AddressableAssets;
using UnityEngine.ResourceManagement.AsyncOperations;

public sealed class AddressableTextureOwner : MonoBehaviour
{
    [SerializeField] private string address = "DemoIcon";
    private AsyncOperationHandle<Texture2D> handle;
    private bool hasHandle;

    private IEnumerator Start()
    {
        // 每次加载操作都要记录可归还的句柄,包括失败路径。
        handle = Addressables.LoadAssetAsync<Texture2D>(address);
        hasHandle = true;
        yield return handle;

        if (handle.Status != AsyncOperationStatus.Succeeded)
        {
            Debug.LogError("加载失败");
            ReleaseOwnedHandle();
            yield break;
        }

        Debug.Log("纹理加载成功");
    }

    private void OnDestroy()
    {
        // 面板销毁时释放;此方法也可处理尚未完成的加载。
        ReleaseOwnedHandle();
    }

    private void ReleaseOwnedHandle()
    {
        if (!hasHandle) return;
        Addressables.Release(handle);
        hasHandle = false;
        Debug.Log("资源句柄已释放");
    }
}

预期输出:资源存在且加载成功后,Console 先显示第一行;销毁挂载脚本的对象后才显示第二行。

text
纹理加载成功
资源句柄已释放

这段示例只加载纹理,不生成实例。若使用 Addressables.InstantiateAsync,应为对应实例调用 Addressables.ReleaseInstance;若用普通 Instantiate 创建对象,应先销毁仍在使用资产的实例,再释放其加载句柄。Resources.Load 和运行时 new Texture2D 又有不同的清理方式,不能把所有资源都交给 GC.Collect。

用相同操作验收修复

重新执行相同的十轮打开、关闭、等待流程,再采一份快照。检查关闭后多余的实例和持有句柄是否消失、纹理与材质对象数是否趋于稳定,以及稳态已使用内存是否停止持续攀升。某些依赖可能因其他合法引用或缓存而暂时保留,因此不能要求每次 Release 后进程内存立即下降。

确认保留者消失、重复操作不再积累多余对象,才算修复了资源生命周期问题。

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

目录与阅读设置

阅读设置

17

记录一个想法

排查资源引用与加载泄漏

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

登录哪都通