Web 图形与 3D / 系统课时
缓存模型加载结果避免重复请求
缓存模型加载结果避免重复请求
多个相同角色容易触发重复下载与解析;直接共用场景根节点,又会让变换和动画相互干扰。这里用规范化 URL 缓存 GLTFLoader 的 Promise,合并并发加载,同时为每个角色创建独立实例,并处理失败后的重试。
学习目标
- 以规范化资源 URL 为键,复用进行中和已完成的 glTF 加载任务。
- 在并发调用与加载失败时正确命中、清理和重试缓存。
- 区分共享网格资源与每个角色独立的节点、骨骼和动画控制器。
区分缓存内容与实例状态
假设关卡里有 20 个 NPC 都使用 /models/character.glb。缓存保存 GLTFLoader 解析得到的 gltf,包括 scene 和 animations;即使浏览器已经缓存下载内容,再调用加载器也不等于复用解析结果。THREE.Cache 主要服务于底层 FileLoader,不能代替这里的解析结果缓存。
一个缓存键始终指向同一个 Promise:请求尚未结束时,第二个调用者直接等待它;请求成功后,后续调用者从已兑现的 Promise 得到同一个 gltf。但是不能把同一个 gltf.scene 同时当作两个角色的根节点,也不能让他们共用 AnimationMixer。

规范化 URL 并复用 Promise
以下示例适用于使用 ES 模块的 Three.js 和 Vite 工程。先在工程内安装 three,将无需额外 Draco/KTX2 解码器的有效 GLB 放在 public/models/character.glb,并确保页面以 src/main.js 作为入口。模型可以没有动画片段。安装命令是 npm install three;成功后启动现有 Vite 开发服务器。
将以下完整代码写入 src/main.js。new URL() 使相对与绝对地址采用同一键;去掉不会随 HTTP 请求发送的 hash,但保留用于区分版本的查询参数,例如 ?v=2。
import { AnimationMixer } from 'three';
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
import * as SkeletonUtils from 'three/addons/utils/SkeletonUtils.js';
const loader = new GLTFLoader();
const modelCache = new Map();
function cacheKey(path) {
const url = new URL(path, document.baseURI);
url.hash = ''; // hash 不影响文件内容;保留 ?v= 等版本参数
return url.href;
}
function loadGLTF(path) {
const key = cacheKey(path);
const cached = modelCache.get(key);
if (cached) return cached;
// 立即保存进行中的 Promise,合并同一时刻的请求
const pending = loader.loadAsync(key).catch((error) => {
if (modelCache.get(key) === pending) modelCache.delete(key);
throw error; // 不把失败结果长期留在缓存中
});
modelCache.set(key, pending);
return pending;
}
async function createCharacter(path) {
const gltf = await loadGLTF(path);
// 克隆节点与骨骼,几何体、材质、动画剪辑仍能共享
const root = SkeletonUtils.clone(gltf.scene);
return {
root,
mixer: new AnimationMixer(root),
clips: gltf.animations
};
}
async function main() {
const relative = '/models/character.glb';
const absolute = new URL(relative, document.baseURI).href;
const [a, b] = await Promise.all([
createCharacter(relative),
createCharacter(absolute)
]);
console.log('缓存项:', modelCache.size);
console.log('根节点独立:', a.root !== b.root);
console.log('Mixer 独立:', a.mixer !== b.mixer);
console.log('动画剪辑共享:', a.clips === b.clips);
}
main().catch(console.error);预期输出(浏览器开发者工具 Console,模型加载成功时):
缓存项: 1
根节点独立: true
Mixer 独立: true
动画剪辑共享: true验证命中、失败清理和重试
打开浏览器开发者工具的 Network 面板,过滤 character.glb,禁用浏览器缓存后刷新。两个 createCharacter() 在 Promise.all() 内并发执行,但只应看到一次该 GLB 的网络请求;modelCache.size 也应为 1。如模型有外部贴图或二进制依赖,额外资源请求不计入这次 GLB 请求数。
失败测试可以暂时把代码中的 relative 改成 /models/missing.glb,刷新后会看到 404 和 main().catch(console.error) 打印的错误。失败处理会把对应键从 Map 删除;之后在相同地址放入有效 GLB,再触发 loadGLTF() 就会重新发起请求,而不是立刻得到上一次的拒绝结果。测试完成后恢复原路径。
这里的规范化只统一相对地址、绝对地址及 hash,不会自动合并不同查询字符串。/models/character.glb?v=1 与 ?v=2 应视为不同版本;如果加载器的解码配置或认证上下文不同,也不应无条件共用同一缓存。
管理共享修改与生命周期
SkeletonUtils.clone(gltf.scene) 会为带骨骼角色复制节点与骨骼绑定,但默认仍引用相同的 geometry、material,而 gltf.animations 可以作为只读剪辑共享。实际场景把每个 root 分别添加到 THREE.Scene,给各自 Mixer 创建 clipAction(),并在每帧以秒为单位分别调用 mixer.update(delta)。
如果两个 NPC 要换不同衣服颜色,直接修改共享材质会让两者一起变化;需要先对该 NPC 的目标材质调用 material.clone() 再修改。动画时间、权重、位置、可见性等实例状态则应保存在各自的根节点、Mixer 或业务对象中,不能写回缓存的原始 gltf.scene。
移除角色时,先停止其动画并清掉 Mixer 对根节点的绑定:mixer.stopAllAction()、mixer.uncacheRoot(root)、root.removeFromParent()。如果该实例有独立骨骼 GPU 资源,可在确认不再使用后释放其 skeleton;但不能对仍被缓存或其他角色引用的共享几何体、材质和纹理调用 dispose()。只有最后一个使用者释放、缓存项也被淘汰后,才由资源管理器统一销毁这些共享资源;单纯 modelCache.delete(key) 不会自动释放 GPU 内存。