Web 图形与 3D / 系统课时
释放几何材质与纹理资源
释放几何材质与纹理资源
角色从场景中移除后,Three.js 不会自动释放所有 GPU 资源。本课将动画混合器、骨骼、几何体、材质和纹理分别纳入清理流程,并实现两个共享 GLB 资源的角色实例:删除一个角色不影响另一个,最后一个退出时才释放共享资源。
学习目标
- 区分场景节点、动画绑定、骨骼与 GPU 资源的生命周期。
- 正确组合
stopAllAction()、uncacheRoot()和各类dispose()接口。 - 使用共享资源所有权与
renderer.info验证清理效果,避免误释放和持续增长的显存占用。
区分实例与共享资源
Three.js 的 scene.remove(root) 只解除父子关系,不会自动销毁节点引用的几何体、材质和纹理。JavaScript 垃圾回收也不能代替 WebGL 资源释放,因此必须明确每种对象由谁拥有、什么时候不再使用。
| 对象 | 清理接口 | 推荐释放时机 |
|---|---|---|
场景节点 Object3D |
parent.remove(root) |
角色退出场景时 |
动画混合器 AnimationMixer |
stopAllAction()、uncacheRoot(root) |
角色退出且不再播放动画时 |
骨骼 Skeleton |
skeleton.dispose() |
没有其他活动网格使用该骨骼时 |
几何体 BufferGeometry |
geometry.dispose() |
最后一个使用者退出时 |
材质 Material |
material.dispose() |
最后一个使用者退出时 |
纹理 Texture |
texture.dispose() |
最后一个使用者退出时 |
材质的 dispose() 不会自动释放其中的 map、normalMap、roughnessMap 等纹理。纹理必须单独清理,因为多个材质可能引用同一个纹理对象。
使用 SkeletonUtils.clone(gltf.scene) 复制蒙皮角色时,角色节点、骨骼层级及其绑定关系会被安全克隆,但几何体和材质仍按引用共享。因此每个角色可以独立播放动画,却不能在单个角色退出时直接销毁共享几何体或贴图。
例如,两个角色 A、B 使用同一个 GLB:二者各有自己的 AnimationMixer 和克隆骨骼,但共享一套几何体、材质与纹理。删除 A 后,共享资源仍属于 B;只有 B 也退出且资产缓存不再保留时,才满足释放条件。
设计正确的释放顺序
角色销毁应先停止行为,再解除引用,最后检查共享资源是否能够销毁。按以下顺序处理可以避免渲染循环继续更新已经退出的角色。
- 将角色从活动实例集合中删除,使下一帧不再调用其
mixer.update(delta)。 - 执行
mixer.stopAllAction(),停止该混合器上的所有动作。 - 执行
mixer.uncacheRoot(root),移除该角色根节点关联的动画动作与属性绑定缓存。 - 执行
scene.remove(root),解除角色与场景的父子关系。 - 对该实例独占的骨骼执行
skeleton.dispose();同一骨骼被多个网格引用时只处理一次。 - 将共享资产的活动引用数减一;如果归零且不再保留缓存,才释放源资产的几何体、材质和纹理。

这里的引用数可以直接采用同一 GLB 资产对应的活动实例集合大小。实际项目如果还保留预加载缓存或其他场景引用,必须将它们计入所有权,不能仅根据当前场景中的角色数量决定是否释放。
在 Vite 项目中完整实现
下面实现一个可运行的双角色示例。前提是使用 Vite 原生 JavaScript 项目,安装 three,并将带骨骼动画的 GLB 文件放在 public/models/character.glb。项目通过 npm install three 安装依赖,执行 npm run dev 启动开发服务器;终端会显示本地访问地址,实际端口可能不同。
将以下代码保存为 src/main.js。示例假定这个 GLB 的几何体、材质、纹理没有被其他资产或全局场景共享,且仅使用 gltf.scene 作为源场景。
import * as THREE from 'three';
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
import * as SkeletonUtils from 'three/addons/utils/SkeletonUtils.js';
const scene = new THREE.Scene();
scene.background = new THREE.Color('#f5f7f9');
const camera = new THREE.PerspectiveCamera(45, 800 / 450, 0.1, 100);
camera.position.set(0, 1.5, 5);
camera.lookAt(0, 1, 0);
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setSize(800, 450);
document.body.appendChild(renderer.domElement);
scene.add(new THREE.HemisphereLight(0xffffff, 0x444444, 2));
const instances = new Map();
let source = await new GLTFLoader().loadAsync('/models/character.glb');
let nextId = 0;
function disposeSharedAsset(root) {
const geometries = new Set();
const materials = new Set();
const textures = new Set();
const skeletons = new Set();
// 同一资源可能被多个网格引用,Set 保证每个对象只释放一次。
root.traverse((node) => {
if (node.geometry) geometries.add(node.geometry);
if (node.isSkinnedMesh) skeletons.add(node.skeleton);
const list = Array.isArray(node.material)
? node.material
: node.material ? [node.material] : [];
list.forEach((material) => materials.add(material));
});
for (const material of materials) {
for (const value of Object.values(material)) {
if (value?.isTexture) textures.add(value);
}
}
skeletons.forEach((item) => item.dispose());
geometries.forEach((item) => item.dispose());
materials.forEach((item) => item.dispose());
// GLTFLoader 可能使用 ImageBitmap;GPU 纹理与 CPU 图像分别释放。
const bitmaps = new Set();
for (const texture of textures) {
const image = texture.source?.data;
if (typeof ImageBitmap !== 'undefined' && image instanceof ImageBitmap) {
bitmaps.add(image);
}
texture.dispose();
}
bitmaps.forEach((image) => image.close());
}
function removeCharacter(id) {
const instance = instances.get(id);
if (!instance) return;
// 先停止动画并解除缓存,避免下一帧继续更新已移除节点。
instances.delete(id);
instance.mixer.stopAllAction();
instance.mixer.uncacheRoot(instance.root);
scene.remove(instance.root);
const skeletons = new Set();
instance.root.traverse((node) => {
if (node.isSkinnedMesh) skeletons.add(node.skeleton);
});
skeletons.forEach((skeleton) => skeleton.dispose());
console.log('剩余实例:', instances.size);
// 最后一个实例退出后,整个源资产才失去所有使用者。
if (instances.size === 0 && source) {
disposeSharedAsset(source.scene);
source = null;
console.log('共享资源已释放');
}
}
function createCharacter(label, x) {
const root = SkeletonUtils.clone(source.scene);
root.position.x = x;
scene.add(root);
const mixer = new THREE.AnimationMixer(root);
if (source.animations.length > 0) {
mixer.clipAction(source.animations[0]).play();
}
const id = ++nextId;
instances.set(id, { root, mixer });
const button = document.createElement('button');
button.textContent = `移除${label}`;
button.addEventListener('click', () => {
removeCharacter(id);
button.remove();
}, { once: true });
document.body.appendChild(button);
}
createCharacter('左侧角色', -1);
createCharacter('右侧角色', 1);
console.log('创建实例:', instances.size);
const clock = new THREE.Clock();
function animate() {
requestAnimationFrame(animate);
const delta = clock.getDelta();
for (const { mixer } of instances.values()) {
mixer.update(delta);
}
renderer.render(scene, camera);
}
animate();预期结果:页面显示两个角色,以及“移除左侧角色”和“移除右侧角色”按钮。角色需要使用约 2 米高、原点接近脚底的测试模型,以适配示例相机;其他尺寸的模型应调整相机和位置。
依次点击两个移除按钮,控制台输出:
创建实例: 2
剩余实例: 1
剩余实例: 0
共享资源已释放第一次点击后,另一个角色仍正常显示和播放动画;第二次点击后,两个角色都从场景中消失,共享资源释放逻辑只执行一次。控制台输出的实例数量是固定的,具体 GPU 对象数量则取决于 GLB 内容。
这里采用两个层次的清理:removeCharacter() 仅处理实例独占的动画与骨骼;disposeSharedAsset() 在最后一个实例退出后遍历源模型,集中销毁共享资源。用 Set 去重可以避免同一材质、纹理或骨骼因为多个网格引用而重复处理。
代码通过扫描材质直接属性收集常规贴图,适用于大多数标准 glTF PBR 材质。如果项目使用自定义 ShaderMaterial.uniforms、额外渲染目标、独立克隆的实例材质或外部共享纹理,还应在各自所有权记录中登记并释放这些对象,不能假设一次场景树遍历覆盖全部资源。
验证显存与避免误释放
先完成一次加载和首次渲染,再打开浏览器开发者工具,在控制台查看 renderer.info.memory。它提供几何体与纹理等资源数量,可用于检测进入和退出场景前后的变化。
在实际工程中,可以在渲染循环或开发调试接口中执行以下片段。片段示例依赖前文已经创建的 renderer,不应作为独立脚本运行。
// 在首次渲染后,以及两次角色移除后的下一帧分别执行。
console.log({
geometries: renderer.info.memory.geometries,
textures: renderer.info.memory.textures,
programs: renderer.info.programs?.length ?? 0
});预期结果:控制台输出包含 geometries、textures、programs 三个数值的对象。它们不是固定常量,不能根据某个测试模型编造统一的预期数量。
按以下顺序验证清理行为:
- 首次加载并渲染两个角色后记录基线,观察几何体与纹理数量。
- 移除第一个角色后再次记录。共享的几何体和纹理通常仍被第二个角色使用,不应因为第一个角色退出而全部消失。
- 移除第二个角色后再渲染一帧,观察不再使用的共享资源数量是否下降。
- 在实际具有重新进入场景能力的应用中,重复加载、进入、退出至少 10 次,记录每轮完全退出后的资源数量是否持续增加。
还需要特别检查以下三个容易遗漏的边界:
- 材质与纹理的所有权不同:
material.clone()通常仍然引用原有纹理。释放某个实例独占的克隆材质,不代表它有权释放共享贴图。 - CPU 图像与 GPU 纹理不同:
texture.dispose()释放 GPU 相关资源,但不会自动关闭ImageBitmap。只有确定没有其他纹理或缓存继续使用同一个位图时,才能调用ImageBitmap.close()。 - 角色退出与整个渲染器退出不同:本例只退出角色,仍保留动画循环和渲染器。如果整个三维视图永久关闭,还要取消帧循环、解绑业务事件,并调用
renderer.dispose()清理渲染器自身资源。
如果业务需要反复生成角色,不必在每个实例退出时销毁缓存的 GLB。可以继续保留源资产并统计活动引用,等关卡切换、缓存淘汰或资源管理器确认无人使用后再集中释放。具体对象释放规则可参考 Three.js 官方资源清理指南。