Web 图形与 3D / 系统课时
循环进入场景检查回收曲线
循环进入场景检查回收曲线
场景退出后内存没有立刻回落,不一定意味着泄漏。Shader 缓存、资源复用和垃圾回收延迟都可能影响读数。本课用同一渲染器连续进出场景 20 轮,在固定卸载点取样,再结合堆快照判断是否存在持续残留。
学习目标
- 设计每轮入场、渲染、卸载、采样一致的压力测试。
- 区分首次预热后的稳定平台与逐轮累加的异常曲线。
- 对照 JS 堆快照和 WebGL 资源计数,定位并复测泄漏。
固定测试边界与采样时点
在相同浏览器版本、相同画布尺寸和相同场景数据下运行测试。每轮必须完成“创建资源、实际渲染一帧、退出场景、调用 dispose()、渲染空场景、下一帧采样”。只创建 Texture 或 Geometry 而不渲染,可能尚未触发 GPU 分配,不能作为有效回收实验。
记录卸载后的 renderer.info.memory.geometries、renderer.info.memory.textures,并辅助查看 renderer.info.programs?.length。它们表示渲染器管理的资源数量,不是显存字节数;背景和环境贴图等内部缓存也可能让计数无法归零。前 2~3 轮视为预热,重点比较第 10 轮和第 20 轮的卸载后基线。
JS 堆与 GPU 资源要分别判断。performance.memory.usedJSHeapSize 仅在部分 Chromium 环境可用,且受 GC 时机影响;最终以 DevTools 手动触发垃圾回收后的 Heap Snapshot 为准。
运行二十轮进出场景测试
将以下内容保存为 index.html。示例固定使用 Three.js 0.180.0,需要能访问 CDN 的网络和支持 WebGL 的浏览器。每轮新建一个几何体、一个画布纹理和一个材质;整个测试始终复用同一个 WebGLRenderer。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>场景循环回收测试</title>
</head>
<body>
<button id="run">运行 10 轮</button>
<span id="status">尚未运行</span>
<pre id="output"></pre>
<div id="view"></div>
<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({ antialias: false });
renderer.setSize(480, 270);
document.querySelector('#view').append(renderer.domElement);
const camera = new THREE.PerspectiveCamera(60, 480 / 270, 0.1, 100);
camera.position.z = 3;
const emptyScene = new THREE.Scene();
const button = document.querySelector('#run');
const status = document.querySelector('#status');
const output = document.querySelector('#output');
const nextFrame = () => new Promise(resolve => requestAnimationFrame(resolve));
let completed = 0;
async function enterAndLeave() {
const scene = new THREE.Scene();
const canvas = document.createElement('canvas');
canvas.width = canvas.height = 64;
const ctx = canvas.getContext('2d');
ctx.fillStyle = '#0d9488';
ctx.fillRect(0, 0, 64, 64);
const geometry = new THREE.BoxGeometry(1, 1, 1);
const texture = new THREE.CanvasTexture(canvas);
const material = new THREE.MeshBasicMaterial({ map: texture });
const mesh = new THREE.Mesh(geometry, material);
scene.add(mesh);
// 必须渲染,才能检验实际创建过的 WebGL 资源。
renderer.render(scene, camera);
await nextFrame();
// 卸载私有资源;渲染器与相机留给下一轮复用。
scene.remove(mesh);
geometry.dispose();
texture.dispose();
material.dispose();
renderer.render(emptyScene, camera);
await nextFrame();
}
function sample() {
const heapBytes = performance.memory?.usedJSHeapSize;
const heapMB = heapBytes === undefined
? 'N/A' : (heapBytes / 1048576).toFixed(1);
const info = renderer.info;
return `${completed}\t${info.memory.geometries}\t${info.memory.textures}\t${info.programs?.length ?? 'N/A'}\t${heapMB}`;
}
button.addEventListener('click', async () => {
button.disabled = true;
const rows = ['轮次\t几何体\t纹理\t程序\tJS堆(MB)'];
try {
for (let i = 0; i < 10; i++) {
await enterAndLeave();
completed++;
rows.push(sample());
}
// 仅保留本批次字符串,避免测试日志长期持有场景对象。
output.textContent = rows.join('\n');
status.textContent = `已完成 ${completed} 轮`;
} finally {
button.disabled = false;
}
});
renderer.render(emptyScene, camera);
</script>
</body>
</html>预期结果:启动页面并点击按钮后,状态依次显示:
已完成 10 轮
已完成 20 轮下方表格每次显示最近 10 轮的卸载后计数。正常情况下,几何体与纹理数不会随轮次持续增加;JS堆(MB) 可能波动,或因浏览器不支持而显示 N/A,不能据此单独判定泄漏。
在 index.html 所在目录用 Python 3 启动本地服务:
python3 -m http.server 8000预期输出(监听主机地址可能不同):
Serving HTTP on <HOST> port 8000 ...浏览器打开 http://localhost:8000/,连续点击按钮两次。不要在测试中途刷新页面,否则累计轮次与缓存基线都会重置。
对照资源曲线与堆快照
把每轮的卸载后读数按轮次连线,不能把场景内峰值与卸载后数值混在同一条曲线上。示例判断:GC 后 JS 堆从 40 MB 到 44 MB 再到 44 MB,纹理计数从 0 到 2 再维持 2,通常符合一次性预热;若 JS 堆从 40 MB 到 51 MB 再到 62 MB,纹理数同步从 0 到 10 再到 20,应优先排查累积残留。这些数字仅用于说明趋势,不是通用阈值。

在 Chrome 或 Edge DevTools 中按以下顺序验证 JS 堆,三次快照都必须在场景退出、异步加载结束后执行:
- 打开
F12 → Memory → Heap snapshot,点击垃圾回收按钮后拍摄基线快照S0。 - 点击“运行 10 轮”,完成后再次垃圾回收,拍摄
S10。 - 再运行 10 轮,以同样方式拍摄
S20;用快照的 Comparison 视图比较对象数量和 retained size。
快照本身只覆盖 JS 堆,不代表 GPU 显存;若测试代码仍保留在控制台变量、应用全局缓存或开发工具临时引用中,先清除这些人为引用再复测。
按增长来源定位并复测
若 geometries 每轮加 1,先检查离场路径是否漏掉 BufferGeometry.dispose();若 textures 增长,检查贴图、渲染目标及后处理资源的 dispose()。若资源计数稳定但 GC 后 JS 堆持续增长,在 S10 与 S20 的 Comparison 和 Retainers 中追踪残留的 Mesh、纹理对象、闭包及 DOM 监听器,确认是否被数组缓存、事件回调或状态管理器继续引用。
真实项目还要停止 requestAnimationFrame 循环、解除事件监听,并对 OrbitControls、EffectComposer 等具有释放接口的对象按其生命周期清理。共享资源应由实际所有者统一释放,不能因为单个场景退出就销毁仍被其他场景使用的纹理或几何体。
修复后重新加载页面,在相同测试配置下从头跑 20 轮,记录第 10 与第 20 轮的卸载后计数,并对照 GC 后堆快照;每组测试中途不要刷新。资源计数进入平台、JS 堆没有随批次稳定抬升,才是比“卸载瞬间是否归零”更可靠的通过标准。