游戏引擎 / 系统课时

Addressables 句柄释放策略

Addressables 句柄释放策略

Addressables 资源已从场景移除,内存却仍不下降,常见原因是加载句柄或实例句柄没有正确释放。本课通过一个可运行的预制体实例管理脚本,讲清引用计数、实例释放、场景切换时机与 Profiler 验证方法,避免资源长期驻留和错误卸载。

学习目标

  • 理解 Addressables 引用计数与 AssetBundle 实际卸载之间的关系。
  • 正确配对 LoadAssetAsync、InstantiateAsync 与对应的释放 API。
  • 使用 Addressables Profiler 检查句柄是否归还,并处理异步加载与场景切换的竞态。

引用计数如何影响资源卸载

Addressables 使用引用计数管理加载操作及其资源依赖。每次显式加载或实例化都会产生需要管理的操作句柄。释放句柄会减少相应引用计数,计数归零后,资源才有资格被卸载。

假设同一个敌人预制体通过 Addressables.InstantiateAsync 创建了两个实例,且没有其他持有者:

  1. 创建敌人 A:产生实例句柄 A,预制体及其依赖被持有。
  2. 创建敌人 B:产生独立的实例句柄 B,共享依赖仍被持有。
  3. 释放 A:只归还 A 对应的引用,B 仍可正常使用资源。
  4. 释放 B:如果没有其他引用,相关资源的引用计数才可能归零。

两个实例句柄与共享资源的引用计数关系

不同加载方式必须使用匹配的释放方法:

创建方式 持有内容 正确释放方式
Addressables.LoadAssetAsync<T> 加载操作句柄 Addressables.Release(handle)
Addressables.InstantiateAsync 每个实例的句柄 Addressables.ReleaseInstance(handle)
InstantiateAsync 且 trackHandle=true Addressables 跟踪的实例 Addressables.ReleaseInstance(gameObject) 也可使用
InstantiateAsync 且 trackHandle=false 调用方保存的实例句柄 必须通过原始句柄释放实例
LoadAssetAsync 后调用 Object.Instantiate 一个加载句柄和自行创建的实例 先 Destroy 所有克隆,再 Addressables.Release(handle)

这里最容易遗漏的是 Unity 原生的 Object.Instantiate 不会增加 Addressables 引用计数。即使创建了十个克隆,Addressables 也不会自动知道这些对象仍然依赖原预制体。提前释放加载句柄,可能导致贴图、材质等依赖被过早卸载。

用实例句柄管理预制体

下面的示例适用于 Unity 6 与 Addressables 2.2.x,使用 AssetReferenceGameObject 在 Inspector 中绑定敌人预制体。脚本允许反复创建和释放一个实例,并处理加载尚未完成就要求释放的情况。

创建 AddressableEnemySlot.cs,将以下完整代码挂到场景中的空物体上:

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

public sealed class AddressableEnemySlot : MonoBehaviour
{
    [SerializeField] private AssetReferenceGameObject prefab;

    private AsyncOperationHandle<GameObject> instanceHandle;
    private bool hasHandle;
    private bool releaseRequested;

    [ContextMenu("Spawn")]
    public void Spawn()
    {
        if (hasHandle) return;

        if (prefab == null || !prefab.RuntimeKeyIsValid())
        {
            Debug.LogError("未配置 Addressable Prefab");
            return;
        }

        // 关闭实例跟踪后,必须保存原始句柄。
        releaseRequested = false;
        instanceHandle = Addressables.InstantiateAsync(
            prefab, transform, false, false);
        hasHandle = true;
        instanceHandle.Completed += OnInstantiated;
    }

    private void OnInstantiated(AsyncOperationHandle<GameObject> op)
    {
        if (!hasHandle) return;

        if (op.Status != AsyncOperationStatus.Succeeded)
        {
            Debug.LogError("实例创建失败");
            ReleaseNow();
            return;
        }

        // 加载期间收到释放请求,则完成后立即归还。
        if (releaseRequested)
            ReleaseNow();
        else
            Debug.Log("实例已创建");
    }

    [ContextMenu("Despawn")]
    public void Despawn()
    {
        if (!hasHandle) return;

        releaseRequested = true;
        if (instanceHandle.IsDone)
            ReleaseNow();
    }

    private void ReleaseNow()
    {
        if (!hasHandle) return;

        if (instanceHandle.IsValid())
        {
            if (instanceHandle.Status == AsyncOperationStatus.Succeeded)
                Addressables.ReleaseInstance(instanceHandle);
            else
                Addressables.Release(instanceHandle);
        }

        hasHandle = false;
        releaseRequested = false;
        Debug.Log("实例句柄已释放");
    }

    private void OnDestroy()
    {
        Despawn();
    }
}

代码中的 InstantiateAsync(prefab, transform, false, false) 使用的是父对象、世界空间保持选项、实例跟踪选项这组参数。最后一个 false 表示不建立从 GameObject 到操作句柄的跟踪映射,因此释放时必须传入保存的 instanceHandle。

hasHandle 防止同一个组件重复申请实例;releaseRequested 处理异步竞态。如果切换场景时对象正在加载,OnDestroy 会提出释放请求,加载完成的回调再执行正确的释放操作,避免漏掉晚到的实例。

在编辑器中运行

  1. 打开 Window > Asset Management > Addressables > Groups,确认敌人 Prefab 已被加入 Addressables Group。
  2. 在场景创建空物体 EnemySlot,挂载脚本,将敌人 Prefab 拖到 Prefab 引用字段。
  3. 进入 Play 模式,在组件标题右侧的菜单中选择 Spawn。
  4. 等待实例出现,再从同一菜单选择 Despawn。
  5. 重复操作三次,检查场景中是否存在未被销毁的旧实例。

预期输出(成功创建并释放一次):

text
实例已创建
实例句柄已释放

每次成功调用 Spawn 都对应一次成功的实例释放。重复执行三次时,上面两条日志各出现三次,且场景中不应留下已释放的实例。日志数量只验证脚本路径,不能单独证明依赖资源已从内存卸载。

如果将实例跟踪参数改为默认的 true,也可以保留原句柄并调用 ReleaseInstance(handle)。但如果只保存 GameObject,则应使用 ReleaseInstance(gameObject),不要混用两种所有权管理方式。

场景切换时怎样安排释放

资源释放时机应由实际使用范围决定,而不是所有内容统一放到 OnDestroy。建议按三种生命周期处理:

资源用途 建议持有范围 释放时机
单个敌人、临时特效 实例存活期 敌人死亡或效果播放结束
关卡地形、当前关卡 UI 当前关卡 关卡退出且使用者不再访问资源后
公共加载界面、跨场景资源 跨场景管理器 最后一个使用者退出时

对于由普通场景直接持有的组件,OnDestroy 是合适的兜底释放位置。但对象若使用 DontDestroyOnLoad 跨场景存在,切换场景不会触发它的销毁回调,此时必须由跨场景管理器显式调用释放方法。

场景切换还要避免 AssetBundle 抖动。例如关卡 A 和关卡 B 都使用同一份角色贴图,如果退出 A 时把共享依赖的最后一个引用释放,随即进入 B 又加载该贴图,就可能出现卸载、重新读取与上传 GPU 的额外成本。

针对这样的共享资源,可采用以下顺序:

  1. 开始加载关卡 B 所需的资源,等待关键共享依赖加载成功。
  2. 停止关卡 A 的相关逻辑,释放已经不再使用的实例。
  3. 确认关卡 A 的其他使用者均已退出,再释放其加载句柄。
  4. 当关卡 B 不再使用共享资源时,归还其最后一个句柄。

这种短暂重叠持有会提高切换阶段的峰值内存,因此需要根据设备内存预算决定是否使用。对于大型独占场景,也可以先释放旧资源、展示加载画面,再加载新资源。

用 Addressables Profiler 检查句柄

Unity 6 配合 Addressables 2.2.x 可以通过 Addressables Profiler 模块查看资源、AssetBundle 和引用句柄的状态。建议使用真实构建的 Addressables 内容进行检查,不要仅凭 Asset Database Play Mode 下的内存变化判断。

按以下步骤准备采样环境:

  1. 打开 Windows 下的 Edit > Preferences > Addressables,或 macOS 下的 Unity 设置,启用 Debug Build Layout。如提示需要安装 Profiling Core API,按提示安装。
  2. 在 Addressables Groups 窗口使用 Build > New Build > Default Build Script 构建内容。
  3. 将 Addressables Play Mode Script 设置为 Use Existing Build,确保实际使用已构建的资源包。
  4. 打开 Window > Analysis > Profiler,在 Profiler Modules 中启用 Addressable Assets。
  5. 进入 Play 模式,依次创建实例、释放实例,在 Profiler 中选择对应采样帧。

重点观察以下指标:

指标 正常现象 异常线索
Handles 归还最后一个持有者后降至 0 场景退出后仍持续大于 0
Status 无其他引用时可进入 Released 不再使用的资源仍保持 Active
Refs By 可追查谁还引用当前内容 被意外的资源或 Bundle 持续引用
AssetBundle 状态 最后一个相关引用释放后可卸载 共享 Bundle 被其他资源继续持有

例如只创建一个敌人,且不存在其他持有者时,释放其实例句柄后,应能在对应资源的引用关系中观察到持有数量下降。如果仍然有引用,继续查看同一资源是否被其他场景、管理器或加载操作持有。

需要注意,Handles 是 Addressables 层面的持有计数,不是原生内存字节数。加载过程中也可能有内部句柄,因此不要要求所有加载状态下的计数都与调用次数完全一致。

即使资源显示 Released,其所在 AssetBundle 也可能因为其他资源仍在使用而保留在内存中。要判断实际内存是否下降,还应同时对照 Memory Profiler 的快照、原生内存和纹理等资源分类。

常见误释放与修正

排查实例长期驻留时,按下面的顺序检查,通常比直接强制清理内存更有效。

  • 实例已经消失但句柄仍被持有:检查是否只执行了 Destroy。对 InstantiateAsync 创建的实例,改为 Addressables.ReleaseInstance。
  • 资源提前释放导致显示异常:检查是否通过 LoadAssetAsync 加载 Prefab 后,又通过原生 Instantiate 创建克隆。先销毁所有克隆,最后释放加载句柄。
  • 释放返回失败:使用 ReleaseInstance(gameObject) 时,确认它确实由 Addressables 创建且启用了实例跟踪;trackHandle=false 必须使用保存的句柄。
  • 切换场景后引用数量不下降:检查静态缓存、跨场景管理器、尚未完成的异步请求,以及是否遗漏了成功或失败操作的句柄释放。
  • 引用已归零但内存仍高:检查共享 AssetBundle、其他资源引用和 Unity 原生内存,不要将所有常驻内存都判断为 Addressables 句柄泄漏。

还要特别检查失败路径。LoadAssetAsync 或 InstantiateAsync 即使加载失败,也应按 API 的规则释放返回的操作句柄,避免操作对象长期保留。释放过的句柄会失效,不允许对同一个句柄重复调用释放方法。

验收时,在相同场景和相同操作顺序下连续执行十次创建与销毁,记录开始和结束时目标资源的 Handles,并比较 Memory Profiler 快照。若没有其他持有者,目标引用应在每轮结束后归零;如果引用计数逐轮增长,应先追踪对应的创建调用和所有权,再决定是否需要调整资源分组或卸载策略。

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

目录与阅读设置

阅读设置

17

记录一个想法

Addressables 句柄释放策略

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

登录哪都通