Web 图形与 3D / 系统课时
区分 JS 堆和 GPU 资源增长
区分 JS 堆和 GPU 资源增长
场景卸载后浏览器进程内存没有立刻下降,并不等于发生泄漏。本课把 Chrome 的 JS 堆快照与 Three.js 的几何体、纹理计数放在同一轮加载与卸载实验中,区分仍被引用的对象、未释放的 GPU 资源,以及会被后续场景复用的内部缓存。
学习目标
- 用堆快照的 Comparison 和 Retainers 定位卸载后仍可达的对象。
- 用
renderer.info.memory对比几何体和纹理的加载前后计数。 - 通过多轮重复实验判断增长是否持续,并采取对应的释放措施。
先分清两种统计口径
| 观察位置 | 看到什么 | 不能据此断言什么 |
|---|---|---|
| Chrome DevTools → Memory → Heap snapshot | 可达的 Mesh、数组、闭包、纹理包装对象及其引用链 |
不能当成 GPU 显存占用 |
renderer.info.memory.geometries |
当前渲染器管理的几何体数量 | 不是 Mesh 数,也不是缓冲区字节数 |
renderer.info.memory.textures |
当前渲染器管理的纹理数量 | 不是纹理显存字节数 |
例如,40 个 Mesh 共用一份 BoxGeometry 和一张 DataTexture,首次渲染后通常增加 1 个几何体、1 张纹理,而不是各增加 40 个。未压缩、无 mipmap 的 RGBA8 纹理由 1024×1024 增至 4096×4096,基础像素存储约从 4 MiB 变为 64 MiB,textures 计数仍是 1。还可参考 renderer.info.programs.length 观察着色器程序数量。

用最小页面重现场景卸载
下面的完整页面适用于 Three.js 0.180.0,用 40 个共享资源的网格模拟一个关卡。复选框可以故意让已卸载的场景继续被 JS 数组引用,但仍释放相应 GPU 资源,以验证两种指标可以背离。
保存为 index.html,在文件目录运行 python3 -m http.server 8000(Windows 也可用 py -m http.server 8000),使用 Chrome 或 Edge 打开 http://localhost:8000。首次运行需要联网加载固定版本的 Three.js。
<!doctype html>
<html lang="zh-CN">
<meta charset="utf-8">
<title>Three.js 内存双指标实验</title>
<button id="load">加载场景</button>
<button id="unload">卸载场景</button>
<label><input id="keep" type="checkbox">故意保留 JS 引用</label>
<pre id="status"></pre>
<script type="module">
import * as THREE from 'https://cdn.jsdelivr.net/npm/three@0.180.0/build/three.module.js';
const renderer = new THREE.WebGLRenderer();
renderer.setSize(480, 260);
document.body.append(renderer.domElement);
const scene = new THREE.Scene();
const camera = new THREE.PerspectiveCamera(55, 480 / 260, 0.1, 100);
camera.position.z = 12;
let active = null;
const retained = []; // 模拟业务缓存忘记移除旧场景
const sample = () => ({
geometries: renderer.info.memory.geometries,
textures: renderer.info.memory.textures,
programs: renderer.info.programs?.length ?? 0
});
function report(stage) {
document.querySelector('#status').textContent =
JSON.stringify({ stage, ...sample(), retainedGroups: retained.length }, null, 2);
}
renderer.render(scene, camera);
const baseline = sample();
report('基线');
document.querySelector('#load').onclick = () => {
if (active) return;
const geometry = new THREE.BoxGeometry(1, 1, 1);
const texture = new THREE.DataTexture(new Uint8Array([255, 150, 70, 255]), 1, 1);
texture.needsUpdate = true; // 首次绘制时上传到 GPU
const material = new THREE.MeshBasicMaterial({ map: texture });
active = new THREE.Group();
for (let i = 0; i < 40; i++) {
const mesh = new THREE.Mesh(geometry, material);
mesh.position.set((i % 10 - 4.5) * 1.05, (Math.floor(i / 10) - 1.5) * 1.05, 0);
mesh.userData.payload = new Array(2000).fill(i); // 便于观察 JS 堆保留
active.add(mesh);
}
scene.add(active);
renderer.render(scene, camera);
report('加载后');
};
document.querySelector('#unload').onclick = () => {
if (!active) return;
scene.remove(active);
const first = active.children[0];
// 所有网格共用这三份资源,只能统一释放一次
first.geometry.dispose();
first.material.map.dispose();
first.material.dispose();
if (document.querySelector('#keep').checked) retained.push(active);
active = null;
renderer.render(scene, camera);
report('卸载后');
const now = sample();
console.log('GPU 资源计数回到基线:',
now.geometries === baseline.geometries && now.textures === baseline.textures);
};
</script>
</html>预期输出(本示例卸载后的浏览器控制台):
GPU 资源计数回到基线: true页面中的 geometries 和 textures 通常在加载后各增加 1,卸载后回到基线。勾选“故意保留 JS 引用”再次加载、卸载,GPU 计数仍可回落,但 retainedGroups 会逐轮增加;这是特意制造的 JS 引用滞留,不应拿来证明 GPU 泄漏。
同步采样并查看引用链
- 不勾选复选框,按
F12打开 Chrome DevTools → Memory → Heap snapshot。在未加载场景时拍快照 A;加载并卸载一次,拍快照 B。拍摄堆快照会先触发垃圾回收,适合比较两次都已卸载的状态。 - 反复执行“加载→卸载”五轮,再拍快照 C。在 C 的 Comparison 中选 B 作比较,关注
Mesh、Group、Array的数量增量和 Retained size;出现新增存活对象时,在 Retainers 查看是哪条数组、闭包或事件监听器仍持有引用。 - 刷新页面重置实验,勾选“故意保留 JS 引用”,重复上述动作。此时各轮 GPU 几何体与纹理计数回落,但 Heap snapshot 能看到旧的网格和
userData.payload仍被retained数组间接引用。 - 每次比较都记录相同阶段(完成卸载并渲染空场景)的
geometries、textures和堆快照;不要拿“刚加载后”的 GPU 计数与“卸载后”的 JS 堆大小直接比较。
如何判断缓存还是泄漏
| 多轮卸载后的变化 | 优先排查方向 |
|---|---|
| JS 存活对象逐轮增加,GPU 计数回到基线 | 未清理的业务数组、订阅、事件监听器或闭包 |
| JS 快照大致稳定,GPU 计数逐轮增加 | 遗漏 geometry.dispose()、texture.dispose(),或渲染目标未释放 |
| 两边持续增加 | 同时检查 JS 引用和 GPU 释放,不能只修其中一边 |
| 首轮上升,此后连续多轮保持平台 | 可能是着色器或环境贴图等内部复用缓存,应核对是否仍有业务对象被持有 |
例如,卸载后的 textures 连续记录为 2、2、2、2,不能仅因不为零就认定泄漏;如果变成 2、4、6、8,才需要沿新建纹理及 dispose() 调用链排查。Three.js 的 scene.background、scene.environment 等可能触发内部资源创建,它们不能都靠遍历场景对象找到,而且会被复用,详见 官方资源释放说明。
真正卸载关卡时,先停掉该关卡的更新和监听,再从场景移除节点;只对不再被其他场景使用的几何体、纹理、材质和 WebGLRenderTarget 分别调用 dispose()。material.dispose() 不会顺带释放纹理;renderer.info.reset() 也只是重置渲染统计,不会清空 GPU 资源。修复后以“卸载、垃圾回收、重复五轮”的稳定基线验收,而不是观察一次浏览器进程内存是否立刻下降。