游戏引擎 / 系统课时
排查资源引用与加载泄漏
排查资源引用与加载泄漏
进入关卡几次后,内存持续上涨,不一定是资源本身太大,也可能是场景实例、加载句柄或静态引用没有释放。本课建立一套可重复的加载实验,借助 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,将一张 Texture2D 标记为 Addressable、地址设为 DemoIcon,把脚本挂到会随面板一起销毁的 GameObject。实际 Player 构建还需准备对应的 Addressables 内容。
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 先显示第一行;销毁挂载脚本的对象后才显示第二行。
纹理加载成功
资源句柄已释放这段示例只加载纹理,不生成实例。若使用 Addressables.InstantiateAsync,应为对应实例调用 Addressables.ReleaseInstance;若用普通 Instantiate 创建对象,应先销毁仍在使用资产的实例,再释放其加载句柄。Resources.Load 和运行时 new Texture2D 又有不同的清理方式,不能把所有资源都交给 GC.Collect。
用相同操作验收修复
重新执行相同的十轮打开、关闭、等待流程,再采一份快照。检查关闭后多余的实例和持有句柄是否消失、纹理与材质对象数是否趋于稳定,以及稳态已使用内存是否停止持续攀升。某些依赖可能因其他合法引用或缓存而暂时保留,因此不能要求每次 Release 后进程内存立即下降。
确认保留者消失、重复操作不再积累多余对象,才算修复了资源生命周期问题。