Cocos bundle加载后如何正确卸载释放资源避免内存泄漏？

Question

在Cocos Creator中，使用bundle加载资源时，若卸载不彻底，易引发内存泄漏。常见问题是开发者仅调用`assetManager.releaseBundle(bundleName)`，但未正确卸载依赖资源或未清理自定义缓存。例如，动态生成的纹理、音频实例可能仍驻留内存。此外，若资源被其他场景引用，释放机制会保留这些资产，导致内存占用居高不下。 **技术问题：** 如何确保在调用`releaseBundle`后，完全释放bundle内资源及其依赖，避免因引用计数或缓存机制导致的内存泄漏？是否需要手动清理特定类型资源（如SpriteFrame、Texture2D），以及如何检测仍有残留引用的资源？

Answer 1

1. 问题概述

在Cocos Creator中，资源管理是游戏性能优化的重要部分。使用`assetManager.releaseBundle(bundleName)`释放资源包时，若未彻底清理依赖资源或自定义缓存，可能导致内存泄漏。例如，动态生成的纹理、音频实例可能仍然驻留在内存中。

以下是常见的内存泄漏场景：

• SpriteFrame或Texture2D等资源未被正确释放。
• 资源被其他场景引用，导致释放机制保留这些资产。
• 开发者未清理自定义缓存或手动创建的对象。

如何确保调用`releaseBundle`后，完全释放bundle内资源及其依赖？这是本篇讨论的核心。

2. 分析与诊断

在深入解决方案之前，我们需要了解Cocos Creator的资源引用计数机制和常见内存泄漏原因。

资源引用计数机制：

资源类型	引用计数行为
Texture2D	当有SpriteFrame或其他对象引用时，引用计数增加。
AudioClip	如果音频正在播放或被其他节点引用，则不会被释放。
Prefab	实例化后，原始Prefab资源的引用计数会增加。

检测残留引用的工具：

// 使用cc.assetManager.getRefCount方法检查引用计数
const refCount = cc.assetManager.getRefCount(asset);
if (refCount > 0) {
    console.log(`Asset ${asset.uuid} has ${refCount} references.`);
}

3. 解决方案

为了彻底释放资源包中的所有资源，以下步骤是必要的：

1. 调用`assetManager.releaseBundle(bundleName)`。
2. 手动清理特定类型的资源（如SpriteFrame、Texture2D）。
3. 清除自定义缓存和动态生成的对象。

具体实现如下：

// 手动清理SpriteFrame和Texture2D
function releaseResourcesInBundle(bundleName) {
    const bundle = cc.assetManager.getBundle(bundleName);
    if (!bundle) return;

    // 遍历所有资源并清理
    for (const asset of bundle.assets) {
        if (asset instanceof cc.SpriteFrame) {
            asset.destroy();
        } else if (asset instanceof cc.Texture2D) {
            asset.decRef(); // 减少引用计数
        }
    }

    // 释放bundle
    cc.assetManager.releaseBundle(bundleName);
}

// 清理自定义缓存
function clearCustomCache() {
    customCache.forEach((value, key) => {
        if (value instanceof cc.Asset) {
            value.decRef();
        }
    });
    customCache.clear();
}

4. 流程图

以下是资源释放的流程图，帮助理解每个步骤的作用：

graph TD;
            A[开始] --> B[调用releaseBundle];
            B --> C{资源是否被引用};
            C --是--> D[手动清理资源];
            D --> E[清理自定义缓存];
            C --否--> E;
            E --> F[结束];

5. 进阶优化

对于复杂项目，建议引入资源监控工具，实时跟踪内存占用情况。例如，使用浏览器开发者工具的Memory选项卡，分析堆内存快照。

此外，定期进行代码审查，确保所有动态生成的对象都被正确销毁。通过日志记录资源加载和卸载的过程，便于排查潜在问题。