Web 图形与 3D / 系统课时

对照堆快照识别残留对象

对照堆快照识别残留对象

场景已从页面移除,堆内存却在反复进入和退出后持续增长,通常意味着某些对象仍被引用。通过 Chrome Heap Snapshot 的多次对照,可以找出残留的 Mesh、闭包、事件监听和缓存引用,并通过复测判断修复是否有效。

学习目标

  • 按一致步骤获取场景卸载前后的三份堆快照。
  • 用 Comparison 和 Retainers 找到残留对象的持有者。
  • 区分 JavaScript 对象残留与 Three.js GPU 资源未释放。

准备可重复的场景样本

使用 Node.js 22.12+ 和兼容的 Vite 版本,在终端新建原生 JavaScript 项目。示例使用 three 包,按钮分别负责创建和卸载场景;不需要依赖其他课时的代码。

bash
# 创建并安装运行所需依赖
npm create vite@latest heap-check -- --template vanilla
cd heap-check
npm install
npm install three
npm run dev

预期结果:终端出现 Vite 的本地访问地址,实际端口可能不是默认值。

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

将 src/main.js 全部替换为以下代码;Vite 模板的 index.html 已引用该入口。cache 模拟业务中的模型缓存,resize 监听和动画循环用于复现常见的卸载引用。

js
import * as THREE from 'three';

const toolbar = document.createElement('div');
const enterButton = document.createElement('button');
const leaveButton = document.createElement('button');
const host = document.createElement('div');
enterButton.textContent = '进入场景';
leaveButton.textContent = '退出场景';
toolbar.append(enterButton, leaveButton);
document.body.replaceChildren(toolbar, host);

const cache = new Set();
let teardown = null;

function createScene() {
  const scene = new THREE.Scene();
  const camera = new THREE.PerspectiveCamera(60, 480 / 300, 0.1, 100);
  camera.position.z = 3;
  const mesh = new THREE.Mesh(
    new THREE.BoxGeometry(1, 1, 1),
    new THREE.MeshBasicMaterial({ color: 0x20a89a })
  );
  scene.add(mesh);
  cache.add(mesh);

  const renderer = new THREE.WebGLRenderer({ antialias: false });
  host.append(renderer.domElement);
  let frameId = 0;

  // 监听器捕获 camera 和 renderer,退出时必须移除。
  function onResize() {
    const width = Math.max(1, Math.min(480, host.clientWidth || 480));
    camera.aspect = width / 300;
    camera.updateProjectionMatrix();
    renderer.setSize(width, 300);
  }
  window.addEventListener('resize', onResize);
  onResize();

  function tick() {
    mesh.rotation.y += 0.01;
    renderer.render(scene, camera);
    frameId = requestAnimationFrame(tick);
  }
  tick();

  return function disposeScene() {
    cancelAnimationFrame(frameId);
    window.removeEventListener('resize', onResize);
    cache.delete(mesh); // 移除业务缓存的强引用。
    scene.remove(mesh);
    mesh.geometry.dispose();
    mesh.material.dispose();
    renderer.dispose();
    renderer.domElement.remove();
  };
}

enterButton.addEventListener('click', () => {
  if (teardown) return;
  teardown = createScene();
  console.log('enter:', cache.size, host.querySelectorAll('canvas').length);
});

leaveButton.addEventListener('click', () => {
  if (!teardown) return;
  teardown();
  teardown = null; // 释放持有场景局部变量的卸载闭包。
  console.log('leave:', cache.size, host.querySelectorAll('canvas').length);
});

预期结果:点击一次「进入场景」显示旋转立方体,点击「退出场景」画布消失,控制台依次出现:

text
enter: 1 1
leave: 0 0

这些数字只能证明示例缓存和 DOM 已清空,不能单独证明全部对象被垃圾回收。

按相同节奏采集三份快照

  1. 打开本地页面,先「进入场景→退出场景」一次完成预热;保持在退出状态。按 F12 打开 Chrome DevTools,进入 Memory → Heap snapshot,选择当前页面的 JavaScript VM,点击 Take snapshot,记为 A。
  2. 重复「进入→退出」5 次,再采集 B;再重复 5 次,采集 C。每次采样都应处于退出状态,不要在两次快照间刷新页面。
  3. 选择快照 C,切换到 Comparison,将基准设为 B;再与 A 比较。观察 Mesh、BoxGeometry、Scene、WebGLRenderer、闭包及 Detached DOM 节点的新增、删除与净变化。
  4. 对持续增加的构造器展开实例并查看下方 Retainers,追踪是什么让它仍可从 GC 根访问。快照采集过程本身会触发垃圾回收,因此比单看任务管理器的内存曲线更适合判断 JS 对象是否仍可达。

三次 Heap Snapshot 对照和 Retainers 引用路径

沿保留路径检查三类根因

在 Comparison 中,先看多轮操作后仍净增的实例数量,再查看 Retainers 的引用链。Shallow size 表示对象自身占用,Retained size 表示该对象不再可达后可能连带释放的大小;单个大数值不等同于一次泄漏。

Retainers 中的常见线索 具体检查与修复
Window、事件监听、system / Context 核对 addEventListener 与 removeEventListener 是否使用同一函数引用;取消 requestAnimationFrame、定时器与订阅。
模块上下文、Array、Map、Set 查找业务缓存、选中对象列表和调试数组;在退出时执行对应的 delete、移除条目或清空专属缓存。
Detached HTMLCanvasElement 或其他 Detached 节点 DOM 已移除但仍有监听器、闭包或应用变量持有它;沿路径找到真正的引用源,不能只反复调用 element.remove()。

Three.js 的 geometry.dispose()、material.dispose()、renderer.dispose()用于释放对应的渲染资源,却不会自动清除业务缓存与外部监听器。贴图还需独立 texture.dispose();共享资源则应在最后一个使用者退出后才释放。Heap Snapshot 主要分析 JavaScript 堆与相关 DOM 节点,不能将其总大小视为显存占用。

故障注入与复测

在示例中临时注释 cache.delete(mesh),刷新页面后重新执行 A、B、C 的采样步骤。由于每次进入都会向 Set 添加一个新 Mesh,而退出时不再删除,B 相对 A、C 相对 B 都应看到这类对象增加,且 Retainers 可追到缓存集合;具体内存字节数不固定。

随后恢复 cache.delete(mesh),刷新页面以清掉故障注入时遗留的引用,再做相同次数的进出与快照比较。验收标准是该示例创建的 Mesh、几何体与材质不再随循环次数持续净增;少量框架内部缓存或初始化开销不必强求归零。若对象数稳定但 GPU 内存仍增长,应另查纹理、渲染目标及 renderer.info.memory,而不是仅根据堆快照下结论。

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

目录与阅读设置

阅读设置

17

记录一个想法

对照堆快照识别残留对象

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

登录哪都通