游戏引擎 / 系统课时
Addressables 句柄释放策略
Addressables 句柄释放策略
Addressables 资源已从场景移除,内存却仍不下降,常见原因是加载句柄或实例句柄没有正确释放。本课通过一个可运行的预制体实例管理脚本,讲清引用计数、实例释放、场景切换时机与 Profiler 验证方法,避免资源长期驻留和错误卸载。
学习目标
- 理解 Addressables 引用计数与 AssetBundle 实际卸载之间的关系。
- 正确配对
LoadAssetAsync、InstantiateAsync与对应的释放 API。 - 使用 Addressables Profiler 检查句柄是否归还,并处理异步加载与场景切换的竞态。
引用计数如何影响资源卸载
Addressables 使用引用计数管理加载操作及其资源依赖。每次显式加载或实例化都会产生需要管理的操作句柄。释放句柄会减少相应引用计数,计数归零后,资源才有资格被卸载。
假设同一个敌人预制体通过 Addressables.InstantiateAsync 创建了两个实例,且没有其他持有者:
- 创建敌人 A:产生实例句柄 A,预制体及其依赖被持有。
- 创建敌人 B:产生独立的实例句柄 B,共享依赖仍被持有。
- 释放 A:只归还 A 对应的引用,B 仍可正常使用资源。
- 释放 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,将以下完整代码挂到场景中的空物体上:
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 会提出释放请求,加载完成的回调再执行正确的释放操作,避免漏掉晚到的实例。
在编辑器中运行
- 打开
Window > Asset Management > Addressables > Groups,确认敌人 Prefab 已被加入 Addressables Group。 - 在场景创建空物体
EnemySlot,挂载脚本,将敌人 Prefab 拖到Prefab引用字段。 - 进入 Play 模式,在组件标题右侧的菜单中选择
Spawn。 - 等待实例出现,再从同一菜单选择
Despawn。 - 重复操作三次,检查场景中是否存在未被销毁的旧实例。
预期输出(成功创建并释放一次):
实例已创建
实例句柄已释放每次成功调用 Spawn 都对应一次成功的实例释放。重复执行三次时,上面两条日志各出现三次,且场景中不应留下已释放的实例。日志数量只验证脚本路径,不能单独证明依赖资源已从内存卸载。
如果将实例跟踪参数改为默认的 true,也可以保留原句柄并调用 ReleaseInstance(handle)。但如果只保存 GameObject,则应使用 ReleaseInstance(gameObject),不要混用两种所有权管理方式。
场景切换时怎样安排释放
资源释放时机应由实际使用范围决定,而不是所有内容统一放到 OnDestroy。建议按三种生命周期处理:
| 资源用途 | 建议持有范围 | 释放时机 |
|---|---|---|
| 单个敌人、临时特效 | 实例存活期 | 敌人死亡或效果播放结束 |
| 关卡地形、当前关卡 UI | 当前关卡 | 关卡退出且使用者不再访问资源后 |
| 公共加载界面、跨场景资源 | 跨场景管理器 | 最后一个使用者退出时 |
对于由普通场景直接持有的组件,OnDestroy 是合适的兜底释放位置。但对象若使用 DontDestroyOnLoad 跨场景存在,切换场景不会触发它的销毁回调,此时必须由跨场景管理器显式调用释放方法。
场景切换还要避免 AssetBundle 抖动。例如关卡 A 和关卡 B 都使用同一份角色贴图,如果退出 A 时把共享依赖的最后一个引用释放,随即进入 B 又加载该贴图,就可能出现卸载、重新读取与上传 GPU 的额外成本。
针对这样的共享资源,可采用以下顺序:
- 开始加载关卡 B 所需的资源,等待关键共享依赖加载成功。
- 停止关卡 A 的相关逻辑,释放已经不再使用的实例。
- 确认关卡 A 的其他使用者均已退出,再释放其加载句柄。
- 当关卡 B 不再使用共享资源时,归还其最后一个句柄。
这种短暂重叠持有会提高切换阶段的峰值内存,因此需要根据设备内存预算决定是否使用。对于大型独占场景,也可以先释放旧资源、展示加载画面,再加载新资源。
用 Addressables Profiler 检查句柄
Unity 6 配合 Addressables 2.2.x 可以通过 Addressables Profiler 模块查看资源、AssetBundle 和引用句柄的状态。建议使用真实构建的 Addressables 内容进行检查,不要仅凭 Asset Database Play Mode 下的内存变化判断。
按以下步骤准备采样环境:
- 打开 Windows 下的
Edit > Preferences > Addressables,或 macOS 下的 Unity 设置,启用Debug Build Layout。如提示需要安装 Profiling Core API,按提示安装。 - 在 Addressables Groups 窗口使用
Build > New Build > Default Build Script构建内容。 - 将 Addressables Play Mode Script 设置为
Use Existing Build,确保实际使用已构建的资源包。 - 打开
Window > Analysis > Profiler,在Profiler Modules中启用Addressable Assets。 - 进入 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 快照。若没有其他持有者,目标引用应在每轮结束后归零;如果引用计数逐轮增长,应先追踪对应的创建调用和所有权,再决定是否需要调整资源分组或卸载策略。