Web 图形与 3D / 系统课时
清理渲染目标和外部订阅
清理渲染目标和外部订阅
页面移除 Three.js 场景后,画布虽然消失,离屏缓冲、后处理通道及仍在触发的回调却可能继续占用资源。本篇以 Three.js r186 为基线,做一个可反复挂载和卸载的示例,确保 GPU 对象与外部订阅按所有权释放。
学习目标
- 区分独立 RenderTarget、EffectComposer 和 Pass 各自负责的 GPU 资源。
- 停止渲染循环,撤销监听和定时器,并执行可重复调用的卸载函数。
- 正确处理独占 Skeleton 与共享资源,并通过多轮测试检查残留。
按所有权清点资源
删除 canvas 或执行 scene.clear() 都不会自动释放 GPU 资源,也不会撤销 window 上的回调。以 r186 的 EffectComposer 为例,其 dispose() 只负责自身双缓冲和内部复制通道,不会遍历并释放用户添加的 Pass(见 r186 源码)。
| 资源归属 | 卸载动作 | 注意点 |
|---|---|---|
自建 WebGLRenderTarget |
target.dispose() |
不归 Composer 管理的目标须自行释放 |
EffectComposer |
composer.dispose() |
释放自身读写缓冲,不能代替 Pass 清理 |
UnrealBloomPass |
bloomPass.dispose() |
释放 Bloom 的中间目标与材质等资源 |
独占 Skeleton |
skeleton.dispose() |
主要释放骨骼纹理;共享实例不可提前释放 |
| 外部回调与控制器 | setAnimationLoop(null)、clearInterval()、removeEventListener()、controls.dispose() |
先停止回调,再销毁其引用的对象 |

实现可重复挂载和卸载的场景
使用 Node.js 20.19+,创建 Vite 原生 JavaScript 工程并固定 Three.js 版本:
npm create vite@latest three-cleanup -- --template vanilla
cd three-cleanup
npm install
npm install three@0.186.0预期结果:工程目录创建成功,依赖安装完成;安装提示或耗时随环境不同。将 src/main.js 完整替换为以下代码。示例中的独立目标只做一次离屏渲染,以演示其独立所有权;正常画面由 Composer 输出。
import * as THREE from 'three';
import { EffectComposer } from 'three/addons/postprocessing/EffectComposer.js';
import { RenderPass } from 'three/addons/postprocessing/RenderPass.js';
import { UnrealBloomPass } from 'three/addons/postprocessing/UnrealBloomPass.js';
import { OrbitControls } from 'three/addons/controls/OrbitControls.js';
const app = document.querySelector('#app');
const button = document.createElement('button');
const host = document.createElement('div');
host.style.maxWidth = '800px';
app.replaceChildren(button, host);
let unmount = null;
button.textContent = '挂载场景';
button.addEventListener('click', () => {
if (unmount) {
unmount();
unmount = null;
button.textContent = '挂载场景';
} else {
unmount = mountScene(host);
button.textContent = '卸载场景';
}
});
function mountScene(container) {
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.toneMapping = THREE.ACESFilmicToneMapping;
renderer.setPixelRatio(Math.min(window.devicePixelRatio || 1, 2));
const scene = new THREE.Scene();
scene.background = new THREE.Color(0x142032);
const camera = new THREE.PerspectiveCamera(60, 16 / 9, 0.1, 50);
camera.position.z = 4;
const geometry = new THREE.BoxGeometry(1.5, 1.5, 1.5);
const material = new THREE.MeshNormalMaterial();
const cube = new THREE.Mesh(geometry, material);
scene.add(cube);
const target = new THREE.WebGLRenderTarget(256, 256);
const composer = new EffectComposer(renderer);
composer.addPass(new RenderPass(scene, camera));
const bloomPass = new UnrealBloomPass(new THREE.Vector2(800, 450), 0.8, 0.2, 0.1);
composer.addPass(bloomPass);
const controls = new OrbitControls(camera, renderer.domElement);
controls.enableDamping = true;
const label = document.createElement('p');
container.replaceChildren(renderer.domElement, label);
const resize = () => {
const width = Math.max(1, container.clientWidth);
const height = Math.max(1, Math.round(width * 9 / 16));
camera.aspect = width / height;
camera.updateProjectionMatrix();
renderer.setSize(width, height);
composer.setSize(width, height);
};
window.addEventListener('resize', resize);
resize();
// 使用一次离屏目标;它与 Composer 的内部缓冲互不隶属。
renderer.setRenderTarget(target);
renderer.render(scene, camera);
renderer.setRenderTarget(null);
let seconds = 0;
const timer = window.setInterval(() => {
label.textContent = `已挂载 ${++seconds} 秒`;
}, 1000);
renderer.setAnimationLoop(() => {
cube.rotation.y += 0.008;
controls.update();
composer.render();
});
let disposed = false;
return () => {
if (disposed) return;
disposed = true;
// 回调和订阅可能持有相机、场景或 DOM 引用,必须先断开。
renderer.setAnimationLoop(null);
window.clearInterval(timer);
window.removeEventListener('resize', resize);
controls.dispose();
// Composer 不会替我们销毁用户传入的 Bloom Pass。
bloomPass.dispose();
composer.dispose();
target.dispose();
geometry.dispose();
material.dispose();
renderer.dispose(); // 此例的 Renderer 由本次挂载独占
container.replaceChildren();
console.log('scene cleaned');
};
}预期结果:启动开发服务器后页面提供挂载与卸载按钮,挂载后渲染旋转方块,卸载时不再触发场景回调。
在工程目录执行:
npm run dev预期输出(终端端口是动态值):
Local: http://localhost:<PORT>/打开终端提供的地址,点击“挂载场景”,可看到旋转方块并能拖动视角,计时文本每秒更新;点击“卸载场景”后画布与计时文本消失,控制台输出:
scene cleaned骨骼资源和共享对象的边界
Skeleton.dispose() 只负责骨骼相关的 GPU 纹理,不会替你释放蒙皮网格的几何体、材质和贴图。若场景中加载了 SkinnedMesh,且确认骨架只归当前场景所有,可以去重后释放。以下是片段示例,依赖已有的 scene,应在停止渲染后、释放 Renderer 前执行:
const skeletons = new Set();
scene.traverse((object) => {
if (object.isSkinnedMesh) skeletons.add(object.skeleton);
});
for (const skeleton of skeletons) skeleton.dispose();预期结果:同一个 Skeleton 即使被多个网格引用,也仅调用一次 dispose();这段代码不产生控制台输出。material.dispose() 也不会自动释放材质引用的贴图,独占贴图还需单独 texture.dispose()。若角色骨架、材质、贴图或 Renderer 被其他场景复用,不能在这里释放,应交给真正的拥有者在最后一个使用者退出时处理。
用反复卸载验证没有残留
- 打开 Chrome DevTools 的 More tools → Performance monitor,观察 JS heap、DOM Nodes、JS event listeners;记录首次挂载与卸载后的大致基线。
- 在演示页重复挂载和卸载 10 次,每次挂载至少运行 3 秒。每次卸载后应恰好新增一条
scene cleaned,画布被移除,不再执行场景定时器或渲染循环。 - 在 Memory → Heap snapshot 分别于首次卸载后及第 10 次卸载后采集快照,执行 GC 后比较
WebGLRenderer、WebGLRenderTarget、OrbitControls相关实例及 Retainers 引用链。若旧实例持续累积,排查未撤销的监听、全局数组或组件闭包。
在使用应用级共享 Renderer 的项目中,场景卸载只释放自己创建的资源;renderer.dispose() 和画布移除要留给应用根容器执行。