3.3 加载预制体关联另外一个预制体

Recovery

使用新版UI制作预制体A里关联了预制体B，现在我要加载预制体A，如果网络不好，加载预制体A本体成功，但是加载关联的预制体B失败了，请问预制体A的加载回调里，是成功还是失败

LayaAir(机器人)

现在我理解了整个加载流程。让我看看关联预制体（依赖资源）加载失败时会怎样处理：

关键逻辑在 HierarchyLoader._load() 中：

先加载预制体A的JSON数据
通过 collectResourceLinks 收集所有依赖资源（包括预制体B）
用 Loader.load(links) 加载所有依赖
依赖全部加载完后，创建 PrefabImpl 对象返回

而 Loader.load 加载数组时用的是 Promise.all（第510行），但每个单独的加载任务在失败时会 catch 住错误并 resolve(null)（第673-680行），不会 reject。所以 Promise.all 总是会 resolve。

回到 HierarchyLoader._load() 的 .then 回调（第51-57行），它直接创建 PrefabImpl 并返回，不检查 resArray 中是否有 null。

结论：预制体A的加载回调是成功的，你会拿到预制体A的资源对象。但是预制体B对应的依赖资源是 null，后续 create() 实例化时，关联预制体B的位置会出问题（可能是空节点或报错）。

如果需要确保所有关联资源都加载成功，可以在加载完成后检查依赖资源是否完整，或者先单独加载预制体B，确认成功后再加载预制体A。

以上由 AI 自动回复，仅供参考。若无异议将不再人工审查；如需人工介入请回帖说明。

Recovery

LayaAir(机器人) 引擎层面有办法确保依赖的lh文件可以确保加载成功吗

LayaAir(机器人)

引擎自带了重试机制，可以通过 Laya.loader.retryNum 和 Laya.loader.retryDelay 来控制：

Laya.loader.retryNum = 3;      // 失败后重试3次（默认1次）
Laya.loader.retryDelay = 1000; // 每次重试间隔1秒（默认0，立即重试）

这对所有资源加载（包括依赖的预制体B）都生效。

但如果重试次数用完仍然失败，引擎不会把依赖失败传递为父资源失败——预制体A的回调仍然是成功。如果你需要严格保证依赖完整，可以自己先加载预制体B，确认成功后再加载A：

let prefabB = await Laya.loader.load("prefabB.lh");
if (!prefabB) {
    // 处理失败，比如重新加载
    return;
}
let prefabA = await Laya.loader.load("prefabA.lh");

这样可以对每个关键依赖做精确的失败处理和重试逻辑。

以上由 AI 自动回复，仅供参考。若无异议将不再人工审查；如需人工介入请回帖说明。

Recovery

人工介入下，确认下是否需要自己判断依赖资源是否加载完成

LayaAir(机器人)

确认一下：是的，目前引擎的行为就是这样——依赖资源加载失败不会导致父预制体加载失败。

从源码看，HierarchyLoader._load() 第 51-57 行，拿到依赖数组后直接创建 PrefabImpl，不检查数组里是否有 null。而 Loader 对单个资源加载失败的处理是 resolve(null) 而不是 reject，所以 Promise.all 永远成功。

所以如果你有关键依赖，确实需要自己保证。两种做法：

先单独加载关键依赖，确认成功后再加载主预制体（上面说过的方式）
加载完主预制体后，检查依赖是否完整：Laya.loader.getRes("prefabB.lh") 看返回值是否为 null

这个行为算是引擎设计上的不足——理论上可以在 HierarchyLoader 里检查依赖是否全部成功，失败时抛出错误或返回 null。但目前版本就是这样，需要业务层自己处理。

以上由 AI 自动回复，仅供参考。若无异议将不再人工审查；如需人工介入请回帖说明。

Recovery

自己检查有问题，比如模型是.fbx，拖入场景后，关联的fbx打包后实际是@0.lh文件，场景加载成功而fbx网络不好加载失败就会导致异常

LayaAir(机器人)

你说得对，打包后 FBX 变成 @0.lh 这种内部路径，业务层根本不知道具体依赖了哪些文件，没法提前单独加载或事后检查。

这确实是引擎的问题。HierarchyLoader 加载依赖资源后，不管依赖是否成功都直接返回成功的 PrefabImpl，应该在依赖加载失败时把失败传递出去。

根因：Loader 对单个资源加载失败的处理是 resolve(null) 而非 reject，导致 Promise.all 永远成功。HierarchyLoader 拿到结果数组后没检查里面是否有 null，直接创建了预制体对象。

目前的处理方式：加载完成后通过 Laya.loader.retryNum 增加重试次数来降低失败概率，这是当前版本下最实际的做法。

🔧 已提交修复 PR（待官方 review 合并，可点击查看改动）：

以上由 AI 自动回复，仅供参考。若无异议将不再人工审查；如需人工介入请回帖说明。

Recovery

loader在加载资源A->B->C 3个关联预制体期间，load只加载了A，B和C是后续关联，如果调用了scene.gc，会可能清理掉加载中的预制体吗

LayaAir(机器人)

不会。引擎的 GC 机制有保护：Resource.destroyUnusedResources() 执行前会检查 loader.loading（即 _loadings.size > 0），如果有任何加载任务正在进行，GC 会被推迟到所有加载完成后再执行。

A 的加载任务在整个依赖链（B、C）全部完成之前一直存在于 _loadings 中，所以在 A->B->C 加载期间调 Scene.gc() 不会清理掉任何正在加载的资源。

以上由 AI 自动回复，仅供参考。若无异议将不再人工审查；如需人工介入请回帖说明。

Recovery

给个有效解决依赖预制体加载失败但是主预制体加载成功的方案

LayaAir(机器人)

最实用的方案是拦截 Loader.warnFailed，它在任何资源加载失败时都会被调用，包括依赖的 @0.lh 这种内部路径：

async function loadPrefabStrict(url: string) {
    let failedUrls: string[] = [];
    let origWarn = Laya.Loader.warnFailed;
    Laya.Loader.warnFailed = function(failUrl: string, err?: any, initiatorUrl?: string) {
        failedUrls.push(failUrl);
        origWarn.call(this, failUrl, err, initiatorUrl);
    };
    
    let res = await Laya.loader.load(url);
    Laya.Loader.warnFailed = origWarn;
    
    if (failedUrls.length > 0) {
        console.error("依赖加载失败:", failedUrls);
        return null; // 视为加载失败
    }
    return res;
}

这样不管依赖链多深、内部路径是什么，只要有任何一个资源失败，你都能捕获到。同时建议把 Laya.loader.retryNum 设大一些（比如 3），减少网络抖动导致的误判。

以上由 AI 自动回复，仅供参考。若无异议将不再人工审查；如需人工介入请回帖说明。

谷主

加载过程中无法对部分失败这种情况做完美的处理，最后的方案依然是打印错误，然后继续。
网络游戏中，如果是由于网络原因导致加载失败，那不会出现一个成功一个失败的情况，一般是全部下载失败；如果是由于缺少文件的情况，那是QA的问题，而不是在正式游戏才去解决问题。
PR已关闭。