Web 图形与 3D / 系统课时
用 GPU 时间查询确认渲染瓶颈
用 GPU 时间查询确认渲染瓶颈
Three.js 场景掉帧时,JavaScript 调用 renderer.render() 的耗时不等于 GPU 真正执行绘制的耗时。本课用 WebGL2 定时查询测量 GPU 指令区间,通过异步读取和 disjoint 校验筛掉无效样本,判断掉帧是否值得从片元着色、阴影或后处理入手。
学习目标
- 区分帧间隔、CPU 提交耗时和 GPU 渲染耗时。
- 使用
EXT_disjoint_timer_query_webgl2包围 Three.js 渲染并跨帧读取结果。 - 在扩展不可用或发生 disjoint 时正确回退,避免错误结论。
先明确测量边界
60 FPS 对应的帧间隔约为 16.67 ms,但这不是单独分配给 GPU 的固定预算。requestAnimationFrame 相邻回调的时间差包括调度影响;performance.now() 包围 renderer.render() 测到的主要是主线程提交工作,GPU 命令通常仍在异步执行。
TIME_ELAPSED_EXT 查询返回两次标记之间的 GPU 耗时,单位为纳秒,换算为毫秒要除以 1e6。用它包围一次 renderer.render(scene, camera),得到的是这次调用提交的 GPU 工作区间;如果项目还用 EffectComposer,应包围实际的 composer.render(),否则后处理不在统计范围内。
查询为什么要跨帧读取
WebGL2 使用 gl.createQuery() 创建查询对象,并通过 gl.beginQuery(ext.TIME_ELAPSED_EXT, query) 与 gl.endQuery(ext.TIME_ELAPSED_EXT) 界定 GPU 指令区间。结束查询时结果通常尚未就绪,必须以后续动画帧轮询。
- 在帧 N 开始查询,执行场景渲染并结束查询。
- 从后续帧读取
gl.QUERY_RESULT_AVAILABLE;未就绪就继续正常渲染,不阻塞等待。 - 检查
ext.GPU_DISJOINT_EXT:为true时 GPU 计时可能不连续,该样本必须丢弃。 - 仅在结果就绪且未 disjoint 时读取
gl.QUERY_RESULT,最后调用gl.deleteQuery()。

搭建 Three.js 测量示例
在支持 WebGL2 的桌面浏览器和 Node.js 环境中,新建 Vite 原生 JavaScript 项目。命令如下;已有 Vite + Three.js 项目可直接替换 src/main.js。
npm create vite@latest gpu-timer-demo -- --template vanilla
cd gpu-timer-demo
npm install
npm install three
npm run dev**预期结果:**终端出现 Vite 本地开发地址(如 http://localhost:<PORT>/),<PORT> 随环境变化。用浏览器打开该地址,将 src/main.js 完整替换为下列代码。
import * as THREE from 'three';
document.body.style.margin = '0';
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
renderer.setSize(innerWidth, innerHeight);
document.body.appendChild(renderer.domElement);
const scene = new THREE.Scene();
scene.background = new THREE.Color(0x111827);
const camera = new THREE.PerspectiveCamera(60, innerWidth / innerHeight, 0.1, 100);
camera.position.z = 25;
const group = new THREE.Group();
scene.add(group);
const geometry = new THREE.BoxGeometry(0.7, 0.7, 0.7);
const material = new THREE.MeshNormalMaterial();
for (let y = -8; y <= 8; y++) {
for (let x = -8; x <= 8; x++) {
const mesh = new THREE.Mesh(geometry, material);
mesh.position.set(x * 1.1, y * 1.1, 0);
group.add(mesh);
}
}
const gl = renderer.getContext();
const ext = gl.getExtension('EXT_disjoint_timer_query_webgl2');
const supported = !!ext &&
gl.getQuery(ext.TIME_ELAPSED_EXT, ext.QUERY_COUNTER_BITS_EXT) > 0;
if (!supported) console.warn('GPU 计时不可用,场景仍可渲染');
if (supported) gl.getParameter(ext.GPU_DISJOINT_EXT); // 先读取并清除历史状态
let pending = null;
let frame = 0;
renderer.setAnimationLoop(() => {
frame++;
const disjoint = supported && gl.getParameter(ext.GPU_DISJOINT_EXT);
// 只查询上一轮的状态,不调用 finish 或忙等
if (pending) {
const ready = gl.getQueryParameter(pending, gl.QUERY_RESULT_AVAILABLE);
if (ready || disjoint) {
if (ready && !disjoint) {
const ns = gl.getQueryParameter(pending, gl.QUERY_RESULT);
console.log(`GPU 渲染耗时: ${(ns / 1e6).toFixed(2)} ms`);
} else if (disjoint) {
console.warn('GPU disjoint,本次测量作废');
}
gl.deleteQuery(pending);
pending = null;
}
}
// 每 30 帧最多发起一次,避免未完成的查询叠加
let query = null;
if (supported && !disjoint && !pending && frame % 30 === 0) {
query = gl.createQuery();
if (query) gl.beginQuery(ext.TIME_ELAPSED_EXT, query);
}
group.rotation.y += 0.003;
renderer.render(scene, camera);
if (query) {
gl.endQuery(ext.TIME_ELAPSED_EXT);
pending = query;
}
});
window.addEventListener('resize', () => {
camera.aspect = innerWidth / innerHeight;
camera.updateProjectionMatrix();
renderer.setSize(innerWidth, innerHeight);
});**预期结果:**页面出现旋转的方块阵列。按 F12 打开浏览器开发者工具的 Console;扩展可用时每隔约 30 帧出现一条类似记录:
GPU 渲染耗时: <TIME> ms<TIME> 是设备相关的实际测量值,不应预设固定数字。扩展不可用时页面仍正常渲染,Console 提示“GPU 计时不可用,场景仍可渲染”。
读数如何指导优化
固定浏览器窗口、设备像素比、模型数量与相机运动,先预热几十帧,再收集约 30 个有效样本,比较中位数而非单帧最大值。下面是判读算例,不是上述示例的实测结果:
| 现象 | GPU 耗时中位数 | 下一步 |
|---|---|---|
| 帧间隔约 25 ms,GPU 约 19 ms | 19 ms | 优先降低分辨率、阴影、透明叠加和后处理,再复测 |
| 帧间隔约 25 ms,GPU 约 3 ms | 3 ms | 转查 Performance 主线程长任务、JS 更新和资源上传 |
| 帧间隔约 16.7 ms,GPU 约 5 ms | 5 ms | 当前 GPU 余量较大,暂不为提升 FPS 盲目降画质 |
GPU 耗时高是定位线索,不能仅凭一次查询证明所有掉帧都由 GPU 引起。对比降低 renderer.setPixelRatio(1) 前后、关闭阴影或后处理前后的同场景有效样本;若 GPU 耗时明显下降且帧间隔同步改善,证据更强。
无效查询与采样陷阱
getExtension() 返回 null 或计时位数为 0 时不要硬调用扩展 API;这属于功能不可用,不等于 GPU 很快。若出现 GPU disjoint,丢弃该次结果并重新采样,不能把零值当作正常耗时。浏览器切换标签页、GPU 重置或 WebGL 上下文丢失后,也应暂停采样,并在上下文恢复后重新获取扩展及查询对象。
完成采样后停止动画循环并删除尚未回收的查询对象;集成到组件时应在卸载钩子中清理。更完整的接口语义可核对 Khronos WebGL2 定时查询规范。