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() 先停止回调,再销毁其引用的对象

场景卸载时 GPU 资源与外部订阅的所有权和清理顺序

实现可重复挂载和卸载的场景

使用 Node.js 20.19+,创建 Vite 原生 JavaScript 工程并固定 Three.js 版本:

bash
npm create vite@latest three-cleanup -- --template vanilla
cd three-cleanup
npm install
npm install three@0.186.0

预期结果:工程目录创建成功,依赖安装完成;安装提示或耗时随环境不同。将 src/main.js 完整替换为以下代码。示例中的独立目标只做一次离屏渲染,以演示其独立所有权;正常画面由 Composer 输出。

js
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');
  };
}

预期结果:启动开发服务器后页面提供挂载与卸载按钮,挂载后渲染旋转方块,卸载时不再触发场景回调。

在工程目录执行:

bash
npm run dev

预期输出(终端端口是动态值):

text
Local: http://localhost:<PORT>/

打开终端提供的地址,点击“挂载场景”,可看到旋转方块并能拖动视角,计时文本每秒更新;点击“卸载场景”后画布与计时文本消失,控制台输出:

text
scene cleaned

骨骼资源和共享对象的边界

Skeleton.dispose() 只负责骨骼相关的 GPU 纹理,不会替你释放蒙皮网格的几何体、材质和贴图。若场景中加载了 SkinnedMesh,且确认骨架只归当前场景所有,可以去重后释放。以下是片段示例,依赖已有的 scene,应在停止渲染后、释放 Renderer 前执行:

js
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 被其他场景复用,不能在这里释放,应交给真正的拥有者在最后一个使用者退出时处理。

用反复卸载验证没有残留

  1. 打开 Chrome DevTools 的 More tools → Performance monitor,观察 JS heap、DOM Nodes、JS event listeners;记录首次挂载与卸载后的大致基线。
  2. 在演示页重复挂载和卸载 10 次,每次挂载至少运行 3 秒。每次卸载后应恰好新增一条 scene cleaned,画布被移除,不再执行场景定时器或渲染循环。
  3. 在 Memory → Heap snapshot 分别于首次卸载后及第 10 次卸载后采集快照,执行 GC 后比较 WebGLRenderer、WebGLRenderTarget、OrbitControls 相关实例及 Retainers 引用链。若旧实例持续累积,排查未撤销的监听、全局数组或组件闭包。

在使用应用级共享 Renderer 的项目中,场景卸载只释放自己创建的资源;renderer.dispose() 和画布移除要留给应用根容器执行。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

清理渲染目标和外部订阅

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通