Web 图形与 3D / 系统课时
对照堆快照识别残留对象
对照堆快照识别残留对象
场景已从页面移除,堆内存却在反复进入和退出后持续增长,通常意味着某些对象仍被引用。通过 Chrome Heap Snapshot 的多次对照,可以找出残留的 Mesh、闭包、事件监听和缓存引用,并通过复测判断修复是否有效。
学习目标
- 按一致步骤获取场景卸载前后的三份堆快照。
- 用 Comparison 和 Retainers 找到残留对象的持有者。
- 区分 JavaScript 对象残留与 Three.js GPU 资源未释放。
准备可重复的场景样本
使用 Node.js 22.12+ 和兼容的 Vite 版本,在终端新建原生 JavaScript 项目。示例使用 three 包,按钮分别负责创建和卸载场景;不需要依赖其他课时的代码。
# 创建并安装运行所需依赖
npm create vite@latest heap-check -- --template vanilla
cd heap-check
npm install
npm install three
npm run dev预期结果:终端出现 Vite 的本地访问地址,实际端口可能不是默认值。
➜ Local: http://localhost:<PORT>/将 src/main.js 全部替换为以下代码;Vite 模板的 index.html 已引用该入口。cache 模拟业务中的模型缓存,resize 监听和动画循环用于复现常见的卸载引用。
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);
});预期结果:点击一次「进入场景」显示旋转立方体,点击「退出场景」画布消失,控制台依次出现:
enter: 1 1
leave: 0 0这些数字只能证明示例缓存和 DOM 已清空,不能单独证明全部对象被垃圾回收。
按相同节奏采集三份快照
- 打开本地页面,先「进入场景→退出场景」一次完成预热;保持在退出状态。按
F12打开 Chrome DevTools,进入 Memory → Heap snapshot,选择当前页面的 JavaScript VM,点击 Take snapshot,记为 A。 - 重复「进入→退出」5 次,再采集 B;再重复 5 次,采集 C。每次采样都应处于退出状态,不要在两次快照间刷新页面。
- 选择快照 C,切换到 Comparison,将基准设为 B;再与 A 比较。观察
Mesh、BoxGeometry、Scene、WebGLRenderer、闭包及DetachedDOM 节点的新增、删除与净变化。 - 对持续增加的构造器展开实例并查看下方 Retainers,追踪是什么让它仍可从 GC 根访问。快照采集过程本身会触发垃圾回收,因此比单看任务管理器的内存曲线更适合判断 JS 对象是否仍可达。

沿保留路径检查三类根因
在 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,而不是仅根据堆快照下结论。