[Bug] 帧内销毁缓存资产后立即加载同一 URL,可能返回已销毁对象

Abierto
#3,201 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
52/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
typescript

Línea de trabajo

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.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

问题

帧内成功请求销毁一个已进入 URL 缓存的资产后,立即调用 ResourceManager.load() 加载同一 URL,会命中等待销毁的旧对象。帧末销毁完成后,加载 Promise 的回调仍会收到这个旧对象,而不是可用的新资产。

这是公共缓存与延迟销毁协议之间的问题,不限于 Mesh,也不应通过让各个 Loader 关闭缓存来修复。

验证状态与版本

  • 已对提交 72aa4f137e4f7ef3675f8f5cba2c801ecf8a45f7 做静态调用链核对。
  • 尚未执行运行时最小复现。以下结果是根据同步帧循环与 Promise 微任务时序推导的,应补自动化测试验证。
  • 前提是资产已加载完成并进入缓存、销毁请求被接受,并且重新加载发生在本帧最终清理之前。

最小复现场景

可优先使用默认开启缓存的 TextureLoader,避免依赖 #3196 对 PrimitiveMeshLoader 的改动:

  1. 创建暂停状态的引擎,通过 resourceManager.load<Texture2D>(url) 加载一张有效图片,确认 getFromCache(url) 返回该纹理。
  2. 不把纹理绑定到材质等引用计数持有者,确保 destroy() 能成功。
  3. 在只执行一次的 Script.onUpdate 中调用以下逻辑,然后通过正常的 engine.update() 推进一帧。
  4. 等待加载 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、帧外立即销毁、帧末后重载。
  • 验证本帧已有工作仍可安全完成,实际底层释放仍发生在原定清理阶段。
Lenguaje dominante
TypeScript
Estrellas
5.9k
Forks
413
Merge medio
16 h 17 min
PR fusionados (30 d)
41

Preparar el entorno

  • Sin Dockerfile ni archivo de Docker Compose
  • Tiene una plantilla de pull request
  • Sin guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de galacean/engine

Todos los issues de galacean/engine

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.