Web 图形与 3D / 系统课时

释放 GPU 资源并恢复丢失上下文

释放 GPU 资源并恢复丢失上下文

WebGL 2 创建的缓冲区、纹理和着色器程序不会因为 JavaScript 变量被置为 null 就立即释放。当页面切换场景或 GPU 上下文意外丢失时,需要分别处理资源回收与运行状态恢复。本课实现一套可运行的资源管理示例,验证主动释放、上下文丢失、GPU 对象重建和重新绘制的完整过程。

学习目标

  • 使用 WebGL 2 的删除接口释放不再使用的 GPU 对象,区分正常释放与上下文丢失。
  • 正确处理 webglcontextlost 和 webglcontextrestored,避免复用已经失效的 GPU 句柄。
  • 使用 WEBGL_lose_context 模拟故障,验证资源重建与渲染循环恢复。

GPU 资源为什么需要显式释放

WebGL 对象由 JavaScript 句柄引用,但实际资源通常位于浏览器管理的图形设备内存中。删除 JavaScript 引用不等于立即执行 GPU 资源删除。浏览器最终可能回收无法访问的 WebGL 对象,但回收时机不确定,因此场景卸载、模型替换和渲染器销毁时应主动调用对应接口。

GPU 对象 释放接口 典型释放时机
顶点或索引缓冲区 gl.deleteBuffer() 网格不再使用
纹理 gl.deleteTexture() 材质或渲染目标卸载
着色器程序 gl.deleteProgram() 材质程序不再使用
顶点数组对象 gl.deleteVertexArray() 网格绑定配置销毁
帧缓冲 gl.deleteFramebuffer() 离屏渲染目标销毁
渲染缓冲 gl.deleteRenderbuffer() 深度或模板附件销毁

对于编译、链接所用的 Shader 对象,可以在 Program 成功链接后调用 gl.deleteShader()。已附着到 Program 的 Shader 会在不再被引用时真正删除,因此不必一直保留独立 Shader 句柄。

删除前先停止使用相关对象,并根据需要解除绑定。例如释放当前 Program 前调用 gl.useProgram(null),释放 VAO 前调用 gl.bindVertexArray(null)。删除完成后,应清空应用保存的对象句柄,防止之后的绘制代码误用。

上下文丢失和恢复的生命周期

上下文丢失与主动释放不同。GPU 驱动重置、设备切换、资源压力或浏览器内部恢复机制都可能导致 WebGL 上下文丢失。此时原有 Buffer、Texture、Program、VAO 和 Framebuffer 等 GPU 对象不再可用,不能依靠重新绑定旧句柄恢复绘制。

应用应在 Canvas 上注册两个事件,并遵循以下处理顺序:

  1. 收到 webglcontextlost:立即调用事件对象的 preventDefault(),允许浏览器尝试恢复上下文;暂停动画循环,标记资源失效。
  2. 等待恢复:保留 CPU 侧的顶点数组、纹理源数据、着色器源码和场景配置,不再执行依赖旧 GPU 对象的操作。
  3. 收到 webglcontextrestored:重新编译链接 Program,创建 Buffer、Texture、VAO 和渲染目标,重新上传数据。
  4. 恢复 GPU 状态:重新设置 viewport、深度测试、混合模式、纹理绑定、Uniform 等状态,再启动绘制循环。

WebGL 2 上下文丢失与 GPU 资源恢复状态图

恢复事件不会自动恢复应用创建的 GPU 对象,WebGL 状态也会回到初始状态。尤其需要重新获取 gl.getUniformLocation() 的结果,以及重新创建依赖顶点属性配置的 VAO。普通 CPU 数据可以继续使用,但以前保存的 GPU 句柄和 UniformLocation 必须重新生成。

实现可恢复的 WebGL 2 渲染器

下面的完整 HTML 示例包含一个使用纹理颜色绘制的三角形,以及主动释放、重新创建、模拟上下文丢失和请求恢复四个操作按钮。将代码保存为 index.html,使用支持 WebGL 2 的桌面浏览器打开即可测试,不依赖第三方库。

示例在 CPU 代码中保留 Shader 源码、顶点数据和纹理像素数据,每次调用 createGpu() 时重新创建真实的 GPU 对象。事件监听器只注册一次,恢复后不会重复创建监听器或叠加动画循环。

html
<!doctype html>
<html lang='zh-CN'>
<head>
<meta charset='utf-8'>
<title>WebGL 2 资源恢复测试</title>
</head>
<body>
<canvas id='scene' width='480' height='270'></canvas>
<div>
  <button id='dispose'>释放 GPU</button>
  <button id='rebuild'>重新创建</button>
  <button id='lose'>模拟丢失</button>
  <button id='restore'>请求恢复</button>
</div>
<p id='status'></p>
<script>
const canvas = document.querySelector('#scene');
const gl = canvas.getContext('webgl2');
const status = document.querySelector('#status');

if (!gl) {
  status.textContent = '此浏览器不支持 WebGL 2';
} else {
  let program = null;
  let buffer = null;
  let vao = null;
  let texture = null;
  let samplerLocation = null;
  let frameId = 0;
  let lost = false;
  let loseExt = gl.getExtension('WEBGL_lose_context');

  function setStatus(message) {
    status.textContent = message;
  }

  function compile(type, source) {
    const shader = gl.createShader(type);
    gl.shaderSource(shader, source);
    gl.compileShader(shader);
    if (!gl.getShaderParameter(shader, gl.COMPILE_STATUS)) {
      const error = gl.getShaderInfoLog(shader);
      gl.deleteShader(shader);
      throw new Error(error);
    }
    return shader;
  }

  function createGpu() {
    // 源码保存在 CPU 侧,恢复时重新编译。
    const vs = compile(gl.VERTEX_SHADER, `#version 300 es
layout(location = 0) in vec2 aPosition;
void main() {
  gl_Position = vec4(aPosition, 0.0, 1.0);
}`);
    const fs = compile(gl.FRAGMENT_SHADER, `#version 300 es
precision highp float;
uniform sampler2D uTex;
out vec4 outColor;
void main() {
  outColor = texelFetch(uTex, ivec2(0, 0), 0);
}`);

    program = gl.createProgram();
    gl.attachShader(program, vs);
    gl.attachShader(program, fs);
    gl.linkProgram(program);
    gl.deleteShader(vs);
    gl.deleteShader(fs);
    if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
      throw new Error(gl.getProgramInfoLog(program));
    }
    samplerLocation = gl.getUniformLocation(program, 'uTex');

    // 重新创建顶点缓冲区及其 VAO 属性配置。
    vao = gl.createVertexArray();
    buffer = gl.createBuffer();
    gl.bindVertexArray(vao);
    gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
    gl.bufferData(gl.ARRAY_BUFFER,
      new Float32Array([-0.6, -0.6, 0.6, -0.6, 0, 0.6]),
      gl.STATIC_DRAW);
    gl.enableVertexAttribArray(0);
    gl.vertexAttribPointer(0, 2, gl.FLOAT, false, 0, 0);
    gl.bindVertexArray(null);

    texture = gl.createTexture();
    gl.activeTexture(gl.TEXTURE0);
    gl.bindTexture(gl.TEXTURE_2D, texture);
    gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA8,
      1, 1, 0, gl.RGBA, gl.UNSIGNED_BYTE,
      new Uint8Array([40, 125, 210, 255]));
    gl.texParameteri(gl.TEXTURE_2D,
      gl.TEXTURE_MIN_FILTER, gl.NEAREST);
    gl.texParameteri(gl.TEXTURE_2D,
      gl.TEXTURE_MAG_FILTER, gl.NEAREST);

    // 上下文恢复后,渲染状态必须重新设置。
    gl.viewport(0, 0, canvas.width, canvas.height);
    gl.clearColor(1, 1, 1, 1);
    gl.disable(gl.DEPTH_TEST);
    gl.disable(gl.BLEND);
  }

  function forgetGpu() {
    program = null;
    buffer = null;
    vao = null;
    texture = null;
    samplerLocation = null;
  }

  function releaseGpu() {
    // 正常释放:先解除绑定,再删除 GPU 对象。
    gl.useProgram(null);
    gl.bindVertexArray(null);
    gl.bindBuffer(gl.ARRAY_BUFFER, null);
    gl.bindTexture(gl.TEXTURE_2D, null);
    if (vao) gl.deleteVertexArray(vao);
    if (buffer) gl.deleteBuffer(buffer);
    if (texture) gl.deleteTexture(texture);
    if (program) gl.deleteProgram(program);
    forgetGpu();
  }

  function frame() {
    if (lost || gl.isContextLost() || !program) {
      frameId = 0;
      return;
    }
    gl.clear(gl.COLOR_BUFFER_BIT);
    gl.useProgram(program);
    gl.bindVertexArray(vao);
    gl.activeTexture(gl.TEXTURE0);
    gl.bindTexture(gl.TEXTURE_2D, texture);
    gl.uniform1i(samplerLocation, 0);
    gl.drawArrays(gl.TRIANGLES, 0, 3);
    frameId = requestAnimationFrame(frame);
  }

  function start() {
    if (!frameId && !lost && program) {
      frameId = requestAnimationFrame(frame);
    }
  }

  function stop() {
    if (frameId) cancelAnimationFrame(frameId);
    frameId = 0;
  }

  canvas.addEventListener('webglcontextlost', event => {
    event.preventDefault();
    lost = true;
    stop();
    // 已丢失的 GPU 对象不再调用 delete*。
    forgetGpu();
    setStatus('上下文已丢失,渲染已暂停');
  });

  canvas.addEventListener('webglcontextrestored', () => {
    lost = false;
    loseExt = gl.getExtension('WEBGL_lose_context');
    try {
      createGpu();
      start();
      setStatus('上下文已恢复,GPU 资源已重建');
    } catch (error) {
      setStatus('重建失败:' + error.message);
    }
  });

  document.querySelector('#dispose').onclick = () => {
    if (lost) return;
    stop();
    releaseGpu();
    gl.clear(gl.COLOR_BUFFER_BIT);
    setStatus('GPU 资源已释放');
  };

  document.querySelector('#rebuild').onclick = () => {
    if (lost) return;
    stop();
    releaseGpu();
    try {
      createGpu();
      start();
      setStatus('GPU 资源已重新创建');
    } catch (error) {
      setStatus('创建失败:' + error.message);
    }
  };

  document.querySelector('#lose').onclick = () => {
    if (loseExt && !gl.isContextLost()) {
      loseExt.loseContext();
    } else {
      setStatus('扩展不可用或上下文已经丢失');
    }
  };

  document.querySelector('#restore').onclick = () => {
    if (loseExt && gl.isContextLost()) {
      loseExt.restoreContext();
    } else {
      setStatus('没有可恢复的模拟丢失上下文');
    }
  };

  createGpu();
  start();
  setStatus('WebGL 2 已就绪');
}
</script>
</body>
</html>

预期结果:页面初始显示白色画布和蓝色三角形。点击「释放 GPU」后,三角形消失,状态显示「GPU 资源已释放」。点击「重新创建」后,三角形再次出现。点击「模拟丢失」,状态变为「上下文已丢失,渲染已暂停」;随后点击「请求恢复」,在恢复事件触发并重建成功后,状态显示「上下文已恢复,GPU 资源已重建」,三角形重新出现。

这个示例把资源创建集中在 createGpu(),把正常删除集中在 releaseGpu(),把丢失时的引用清理集中在 forgetGpu()。三者职责不同:正常卸载需要调用删除接口;上下文已经丢失时只丢弃旧句柄;恢复时重新创建对象并设置状态。

示例每帧都会重新绘制,便于观察暂停和恢复。实际静态场景可以改为数据变化后按需渲染,以减少无意义的 GPU 工作。完整项目还需要根据已有资源补充深度附件、离屏帧缓冲、Sampler 和其他 WebGL 状态的重建逻辑。

验证资源回收与处理常见故障

可以按照以下顺序验收,不要只检查页面是否重新出现画面。

  1. 打开页面,确认蓝色三角形正常显示,控制台没有 Shader 编译错误。
  2. 点击「释放 GPU」,确认绘制停止;再次点击「重新创建」,确认新的 Program、Buffer、Texture 和 VAO 可以完成绘制。
  3. 点击「模拟丢失」,确认动画循环停止,并且不会持续尝试调用失效的 GPU 对象。
  4. 点击「请求恢复」,确认恢复事件到达,资源重建后画面再次出现。连续进行两到三次模拟丢失与恢复,检查是否出现重复动画循环或重建失败。

WEBGL_lose_context 是 WebGL 1 和 WebGL 2 都可使用的扩展,但应先通过 gl.getExtension('WEBGL_lose_context') 检查是否可用。它的 restoreContext() 只会请求恢复,不能假设调用后立即可绘制。真正重新初始化资源的时机是 webglcontextrestored 事件。

现象 常见原因 修复方式
模拟丢失后不能恢复 丢失事件没有调用 preventDefault() 在事件回调中同步调用
恢复后黑屏 继续使用旧 Buffer、VAO 或 Program 重新创建并上传 GPU 资源
恢复后颜色异常 纹理、Uniform 或混合状态没有恢复 重新设置材质与渲染状态
恢复后重复绘制、性能下降 每次恢复又注册监听器或开启多个循环 事件只注册一次,启动循环前检查状态
场景反复切换后内存持续增加 旧纹理、帧缓冲或缓冲区未释放 在资源所有者卸载时统一调用删除接口

排查黑屏时,先用 gl.isContextLost() 确认上下文是否仍处于丢失状态,再检查 Shader 编译和 Program 链接结果,最后验证资源是否重新上传。上下文丢失期间的 gl.getError() 不适合作为普通绘制错误来处理,应把上下文恢复问题单独记录。

还需要注意两类资源的生命周期不同:主动调用 deleteTexture() 只释放对应 WebGL 对象,不会自动销毁 JavaScript 数组、图片对象或事件监听器;反过来,释放 JavaScript 引用也不能替代及时的 GPU 资源删除。实际页面关闭或渲染器卸载时,应先停止动画循环,再删除仍然有效的 GPU 对象,并清理不再需要的 CPU 数据和事件订阅。

当设备无法恢复上下文时,不应无限重试提交绘制命令。可以保留 CPU 侧场景状态,在页面上提示图形渲染暂时不可用,并等待新的恢复事件或让用户重新初始化场景。能够重复经历资源释放、上下文丢失和重建而不产生重复循环、旧句柄访问或持续内存增长,才说明资源生命周期管理符合预期。

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

目录与阅读设置

阅读设置

17

记录一个想法

释放 GPU 资源并恢复丢失上下文

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

登录哪都通