[Bug] 帧内销毁缓存资产后立即加载同一 URL,可能返回已销毁对象
I maintainer di solito rispondono entro 1 giorno
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 4/5
- Tempo stimato
- 3-5 giorni
- Idoneità per principianti
- 52/100
- Tipo di issue
- Bug
- Chiarezza
- Specificata chiaramente
- Stato di attività
- Attiva
- Stack tecnologico
- typescript
Direzione di ricerca
Read packages/core/src/base/EngineObject.ts, packages/core/src/asset/ResourceManager.ts, and the existing resource manager tests first. Add an automated test using the public API and a real engine frame loop to check that destroying a cached asset and loading the same URL returns a usable new asset. Include the listed cases for rejected destruction, cache mappings, and deferred release; done means the regression and lifecycle checks pass.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
问题
帧内成功请求销毁一个已进入 URL 缓存的资产后,立即调用 ResourceManager.load() 加载同一 URL,会命中等待销毁的旧对象。帧末销毁完成后,加载 Promise 的回调仍会收到这个旧对象,而不是可用的新资产。
这是公共缓存与延迟销毁协议之间的问题,不限于 Mesh,也不应通过让各个 Loader 关闭缓存来修复。
验证状态与版本
- 已对提交
72aa4f137e4f7ef3675f8f5cba2c801ecf8a45f7做静态调用链核对。 - 尚未执行运行时最小复现。以下结果是根据同步帧循环与 Promise 微任务时序推导的,应补自动化测试验证。
- 前提是资产已加载完成并进入缓存、销毁请求被接受,并且重新加载发生在本帧最终清理之前。
最小复现场景
可优先使用默认开启缓存的 TextureLoader,避免依赖 #3196 对 PrimitiveMeshLoader 的改动:
- 创建暂停状态的引擎,通过
resourceManager.load<Texture2D>(url)加载一张有效图片,确认getFromCache(url)返回该纹理。 - 不把纹理绑定到材质等引用计数持有者,确保
destroy()能成功。 - 在只执行一次的 Script.onUpdate 中调用以下逻辑,然后通过正常的
engine.update()推进一帧。 - 等待加载 Promise 回调并检查对象身份和销毁状态。
示意代码(尚未执行):
// oldTexture 已通过 ResourceManager 加载完成,且未被材质等持有。
onUpdate() {
if (this.ran) return;
this.ran = true;
const accepted = oldTexture.destroy();
console.assert(accepted);
console.assert(oldTexture.pendingDestroy);
this.engine.resourceManager.load<Texture2D>(url).then((loaded) => {
// 当前代码路径推导出的异常结果:
console.log(loaded === oldTexture); // true
console.log(loaded.destroyed); // true
});
}
如果引用计数让 destroy() 返回 false,则不属于这个复现场景。帧外立即销毁、或在帧末清理完成后才重新发起加载,也不属于这个时间窗口。
预期与实际
预期:销毁请求被接受后,新的加载请求不再取得这个待销毁对象;重新加载应返回可用的新资产。本帧已有使用者需要的底层资源仍可保留到帧末释放。
静态推导的实际行为:
| 时刻 | 行为 |
|---|---|
| 帧内 destroy() | 仅标记 pendingDestroy 并入队,URL 缓存尚未移除 |
| 紧接着 load(url) | 缓存命中旧对象,Promise 捕获该引用,不重新调用 Loader |
| 帧末 | 执行实际销毁,移除缓存并释放资源 |
| Promise 回调 | 成功返回已销毁的旧对象;缓存清理不能替换 Promise 已捕获的引用 |
后续使用可能导致资源不显示或访问已清理数据时报错,具体表现取决于消费者;本 issue 不将“必然崩溃”作为已验证结论。
根因与代码证据
- EngineObject.destroy / _onDestroy:帧内请求销毁只设置 pendingDestroy,缓存移除放在最终 _onDestroy。
- ResourceManager:_loadSingleItem 命中 _assetUrlPool 时未检查 pendingDestroy;_deleteAsset 负责清除对象与 URL 的双向索引。
- Engine.update:本帧渲染后同步处理延迟销毁队列。
- AssetPromise:使用原生 Promise,then 回调在同步帧处理结束后执行。
根因是“停止向新请求提供资产”和“最终释放资产”使用了同一个延迟时机。缓存开启只是触发条件。
历史与关联
- #2894(2026-02-25,
c420cf0f2)引入 EngineObject 帧内延迟销毁。对照该提交的缓存逻辑,这个时间窗口当时就已存在。 - 引入延迟销毁之前,成功销毁会同步清理缓存,不存在上述窗口。
- #3196 的
72aa4f1将 PrimitiveMeshLoader 从 useCache=false 改为默认 true,使其也进入受影响范围;它并非公共问题的起点。旧二进制 MeshLoader 原本已默认开启缓存。 - 影响范围应按“使用公共缓存、支持销毁且销毁被延迟”的资产判断,不代表所有 Loader 返回值都必然受影响。
建议修复边界
在公共生命周期与 ResourceManager 边界处理:成功接受销毁请求时解除缓存映射,底层资源仍在帧末释放。
需要保证:
- 销毁因引用计数被拒绝时,不移除缓存。
- 对象 ID → URL、URL → 对象两个索引一致清理。
- 清理幂等;旧对象最终销毁时不能误删同一 URL 下后来发布的新对象,必要时核对对象身份。
- 缓存读取、加载结果发布与销毁之间遵守一致的对象有效性规则。
- 保留延迟释放对本帧物理、脚本和渲染流程的保护。
验收
- 使用真实引擎帧循环和公开 API,复现 destroy → 同 URL load,修复前失败、修复后通过。
- 新加载结果不是旧对象,且 destroyed / pendingDestroy 均为 false。
- 覆盖至少两类缓存资产,例如 Texture2D 和开启缓存的 PrimitiveMesh。
- destroy 被引用计数拒绝时,缓存及原资产保持有效。
- 旧对象最终清理不会删除新对象的缓存映射。
- 覆盖重复 destroy、帧外立即销毁、帧末后重载。
- 验证本帧已有工作仍可安全完成,实际底层释放仍发生在原定清理阶段。
- Lingua principale
- TypeScript
- Stelle
- 5.9k
- Fork
- 413
- Merge medio
- 16h 17m
- PR unite (30g)
- 41
Preparare l'ambiente
- Nessun Dockerfile né file Docker Compose
- Ha un modello di pull request
- Nessuna guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di galacean/engine
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 64/100
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 85/100
I maintainer di solito rispondono entro 1 giorno
-
RFC: Adopt Unity-style Collider components and hierarchical Rigidbody ownershipForse già presa Una pull request collegata a questa issue è aperta o già unita. Aperta
Difficoltà 5/5 Più di una settimana Idoneità per principianti 20/100
I maintainer di solito rispondono entro 1 giorno
-
SkinnedMeshRenderer should derive default rootBone-space localBounds from mesh and skinForse già presa Una pull request collegata a questa issue è aperta o già unita. Apertaenhancement
Difficoltà 4/5 3-5 giorni Idoneità per principianti 42/100
I maintainer di solito rispondono entro 1 giorno
-
performance
Difficoltà 5/5 Più di una settimana Idoneità per principianti 25/100
I maintainer di solito rispondono entro 1 giorno
Tutte le issue di galacean/engine
Issue simili
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 76/100
I maintainer di solito rispondono entro 1 giorno
-
e2e-failure ready-to-code
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 72/100
redhat-developer/rhdh-plugin-export-overlays#4794 · 1 commento ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 82/100
I maintainer di solito rispondono entro 1 giorno
-
area: plugins documentation good first issue
Difficoltà 2/5 1-3 ore Idoneità per principianti 83/100
CatVinci-Studio/Textus#727 ·
I maintainer di solito rispondono entro 1 giorno