火狐浏览器WebGL白屏主因是GPU资源被系统或浏览器回收，需从黑名单绕过、WebRender启用、上下文监听三方面解决：先在about:config中禁用gfx.blacklist.*并启用webgl.force-enabled；再开启gfx.webrender.all和layers.acceleration.force-enabled；最后用addEventListener监听webglcontextlost/restored事件并重建资源。
火狐浏览器在Windows 11系统下运行WebGL应用时，突然白屏、控制台报“WebGL context lost”、3D模型消失或贴图错乱，不是代码写错了，而是GPU资源被操作系统或浏览器主动回收——这种丢失高频发生在合盖休眠、切换到后台超过2分钟、播放4K视频后切回页面等真实用户场景中。
确认是否真被GPU黑名单拦截
打开火狐地址栏，输入 about:config → 点击「接受风险并继续」→ 搜索 webgl.disabled，确认其值为 false；再搜索 webgl.force-enabled，确保为 true。
若仍无效，搜索 gfx.blacklist.direct3d11 和 gfx.blacklist.webgl，双击将两者设为 0（禁用黑名单检测）——老旧核显（如Intel HD Graphics 4400/520）或OEM预装驱动常被误判为不兼容，强制绕过可立即恢复WebGL 2.0支持。
强制启用WebRender GPU合成后端
仅开硬件加速不够，必须激活WebRender全链路GPU渲染：
① 搜索 gfx.webrender.all → 设为 true；
② 搜索 gfx.webrender.force-enabled → 若不存在则右键新建布尔值，填入该名称并设为 true；
③ 搜索 gfx.webrender.software → 必须为 false，否则会退化到CPU光栅化，触发上下文不稳定；
④ 搜索 layers.acceleration.force-enabled → 设为 true，确保图层合成不被降级。
【重启Firefox进程必须彻底：任务管理器中结束所有firefox.exe，否则配置不生效】
监听上下文事件并重建资源
方法一：基础事件绑定
在获取上下文后立即注册监听：
const gl = canvas.getContext('webgl', { preserveDrawingBuffer: true });
canvas.addEventListener('webglcontextlost', e => { e.preventDefault(); console.warn('上下文即将丢失'); }, false);
canvas.addEventListener('webglcontextrestored', () => { initShaders(); initBuffers(); initTextures(); }, false);
方法二：结合页面可见性控制
在 visibilitychange 事件中暂停渲染循环，避免后台持续调用gl.drawArrays()触发INVALID_OPERATION；切回前台时先检查 gl.isContextLost() 返回true才执行重建，否则跳过冗余初始化。
【preserveDrawingBuffer: true 必须在getContext时传入，之后无法动态修改】
验证当前WebGL状态是否真实启用
访问 about:support 页面 → 查看「图形」章节 → 确认「WebGL 1.0 Renderer」和「WebGL 2.0 Renderer」两项均显示具体GPU型号（如“AMD Radeon RX 6700 XT”），且状态为「Available」；若显示「Disabled」或「Software only」，说明底层未走GPU路径，前述所有监听都无效。
若此处异常，返回 about:config 检查 webgl.out-of-process 是否为 true（Win11下推荐开启，隔离GPU进程崩溃影响）。
