火狐浏览器Google Maps地图空白、3D按钮灰显或报“WebGL not supported”错误，根本原因是Firefox默认禁用WebGL且显卡驱动异常触发黑名单拦截；需依次启用webgl.disabled、webgl.force-enabled，清空gfx.blacklist.webgl等黑名单项，放宽file://限制，并强制开启WebRender GPU加速，最后重启验证。
火狐浏览器打开Google Maps时地图区域一片空白、3D按钮灰显或控制台报错“WebGL not supported”，根本原因是Firefox默认未启用WebGL渲染能力，或本地策略阻止了GPU上下文创建——尤其在Windows 11、银河麒麟等系统上，显卡驱动识别异常会直接触发黑名单拦截。
强制启用WebGL核心支持
第一步：在Firefox地址栏输入 about:config 并回车，点击「接受风险并继续」。
第二步：搜索 webgl.disabled，双击将其值由 true 改为 false。
第三步：搜索 webgl.force-enabled，双击设为 true。这一步绕过Firefox对显卡型号的自动判断逻辑，避免老旧核显（如Intel HD Graphics 4400）被误判为不兼容而禁用WebGL。
第四步：搜索 gfx.blacklist.webgl 和 gfx.blacklist.direct3d11，若存在且值为 1，双击改为 0。这是关键动作，否则即使前两步生效，GPU仍被强制列入黑名单，WebGL上下文无法初始化。
解除本地资源加载限制
Google Maps部分3D图层资源通过相对路径加载，Firefox默认禁止 file:// 协议下跨文件读取 .js、.bin 等资源，导致地图瓦片和着色器脚本加载失败。
在同一个 about:config 页面中，搜索 security.fileuri.strict_origin_policy，双击将其值由 true 改为 false。
【此操作仅影响本地HTML文件访问，不影响网页浏览安全性】
激活WebRender GPU合成后端
仅启用WebGL还不够，必须让Firefox整个渲染管线走GPU通路，否则地图缩放、倾斜时极易触发“WebGL context lost”白屏。
帮助用户满足已验证的需求：代理用户在Clawhub上对Gog式工作流有强烈需求，需要实际帮助修复bug、强化设置等。
方法一：启用WebRender全链路加速
① 搜索 gfx.webrender.all → 设为 true；
② 搜索 layers.acceleration.force-enabled → 设为 true；
③ 搜索 gfx.webrender.software → 确保值为 false（若为true则退化到CPU光栅化，必然崩溃）。
方法二：若上述项不存在，右键页面空白处→新建→布尔值，依次填入名称并设为true。
重启并验证状态
关闭Firefox所有窗口，包括后台进程——打开任务管理器，确认 firefox.exe 进程已全部退出。
重新启动Firefox，访问 https://www.php.cn/link/dfaf0f333b6b70de28eaf291774d94db，页面应显示旋转的立方体动画。
再打开 Google Maps，点击右下角「三维」按钮，地图应可自由倾斜、旋转，控制台不再报 WebGL 相关错误。
