[Bug] 帧内销毁缓存资产后立即加载同一 URL,可能返回已销毁对象
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 4/5
- 見積もり時間
- 3〜5日
- 初心者へのやさしさ
- 52/100
- issue の種類
- バグ
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
- 技術スタック
- typescript
調査の方向性
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.
索引モデルが issue の本文から書いたものです。
説明
问题
帧内成功请求销毁一个已进入 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、帧外立即销毁、帧末后重载。
- 验证本帧已有工作仍可安全完成,实际底层释放仍发生在原定清理阶段。
- 主要言語
- TypeScript
- スター
- 5.9k
- フォーク
- 413
- 平均マージ
- 16時間 17分
- マージ済み PR(30日)
- 41
環境構築
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートあり
- コントリビューションガイドなし
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
galacean/engine のほかの issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 64/100
メンテナーはふだん 1 日以内に返信
-
難易度 1/5 1時間未満 初心者へのやさしさ 85/100
メンテナーはふだん 1 日以内に返信
-
RFC: Adopt Unity-style Collider components and hierarchical Rigidbody ownership対応中かも このイシューにリンクされたプルリクエストがオープン中、またはマージ済みです。 オープン
難易度 5/5 1週間以上 初心者へのやさしさ 20/100
メンテナーはふだん 1 日以内に返信
-
SkinnedMeshRenderer should derive default rootBone-space localBounds from mesh and skin対応中かも このイシューにリンクされたプルリクエストがオープン中、またはマージ済みです。 オープンenhancement
難易度 4/5 3〜5日 初心者へのやさしさ 42/100
メンテナーはふだん 1 日以内に返信
-
performance
難易度 5/5 1週間以上 初心者へのやさしさ 25/100
メンテナーはふだん 1 日以内に返信
galacean/engine の issue をすべて見る
似ている issue
-
bug impact:low Team: SecuritySolution Team:Defend Workflows v9.6.0
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
elastic/kibana#306401 · コメント 3 件 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
agentes-chat/agentes-chat#927 ·
メンテナーはふだん 1 日以内に返信
-
comp/desktop P2 type/bug
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
NousResearch/hermes-agent#157702 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
メンテナーはふだん 1 日以内に返信
-
e2e-failure ready-to-code
難易度 1/5 1時間未満 初心者へのやさしさ 72/100
redhat-developer/rhdh-plugin-export-overlays#4794 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信