WebGL2 不可用？3D 預覽依平台排查

你看到的症狀

預覽區提示「3D 預覽不可用」，或頁面空白、無模型顯示。Any3D 的線上預覽依賴 WebGL2 在 GPU 上渲染 3D 場景；WebGL2 不可用時預覽無法啟動。

常見原因

原因	典型場景
硬體加速關閉	瀏覽器或系統設定停用 GPU
顯卡驅動過舊/異常	Windows 筆記型電腦雙顯卡、Linux 開源驅動
瀏覽器黑名單	極舊 GPU 被瀏覽器列入軟體渲染清單
遠端桌面 / 虛擬機	RDP、VM 無 GPU 透傳
企業策略	GPO 停用硬體加速、VDI 無 3D 加速
WebView / 舊核心	微信、釘釘、舊 App
擴充干擾	強制 Canvas 指紋防護類外掛

依平台排查

Windows

1. 開啟硬體加速
   Chrome/Edge：設定 → 系統 →「使用硬體加速（如可用）」→ 重啟瀏覽器。

2. 更新顯卡驅動
   NVIDIA / AMD / Intel 官網或 Windows Update 安裝最新驅動。筆記型電腦在顯卡控制面板中將瀏覽器設為「高效能」。

3. 群組原則 / 註冊表（企業）
   IT 可能透過原則停用 GPU 合成。個人使用者可檢查 chrome://gpu 是否大量「Software only」。

4. 遠端桌面
   RDP 到辦公機時 WebGL 常不可用——本機 PC 瀏覽器開啟 Any3D，或使用支援 GPU 的遠端方案。

5. 家長控制
   Windows 家庭安全子帳戶一般不禁 WebGL；若使用第三方「兒童瀏覽器」，換 Chrome/Edge 測試。

macOS

1. Safari / Chrome 最新版；系統設定 → 顯示器 → 更新頻率/解析度正常即可。
2. 低耗電模式 下 GPU 降頻，極端情況影響 WebGL——插電重試。
3. 螢幕使用時間 不直接禁 WebGL；MDM 限制圖形時需聯繫 IT。

Linux

1. 專有驅動（NVIDIA）或較新 Mesa；chrome://gpu 查看 GL 狀態。
2. Wayland 與 X11 若一側失敗可切換工作階段對比。

iOS / iPadOS

1. Safari 對 WebGL2 支援較佳；保持系統更新。
2. 低耗電模式 可能限制效能，預覽卡頓或失敗——充電後重試。
3. App 內 WebView → Safari 開啟。
4. 學校監管 iPad 若禁止「相機/檔案」不影響 WebGL，但禁止系統更新會導致核心過舊。

Android

1. 更新 Chrome；開啟 開發者選項 → 強制 GPU 渲染（部分舊機有效，新系統可能已預設）。
2. 國產瀏覽器相容核心常無 WebGL2 → 用 Chrome。
3. 省電模式 限制 GPU——關閉後重試。

網路、VPN 與企業內網

WebGL2 為本機 GPU API，通常不受 VPN 直接影響。但以下情況需留意：

場景	說明
企業 VDI（Citrix/VMware）	未啟用 GPU 透傳時 WebGL 不可用，需 IT 開啟 vGPU 或本機瀏覽器
VPN 強制安裝瀏覽器擴充	擴充可能干擾 WebGL 上下文
內網僅允許 IE/舊 Edge	無 WebGL2，必須換現代 Chromium 瀏覽器

家長控制與公共環境

• 圖書館/學校 PC：可能使用鎖定版瀏覽器或無獨顯——換個人筆記型電腦驗證。
• Family Link 限制 Chrome 版本：允許 Play 商店更新 Chrome。

分步修復（通用）

1. 開啟 chrome://gpu（Chrome/Edge）或 about:support → 圖形，查看 WebGL2 是否 Hardware accelerated。
2. 開啟硬體加速，更新驅動，重啟瀏覽器與系統。
3. 無痕視窗排除擴充。

快速自測

(() => {
  const c = document.createElement("canvas");
  return c.getContext("webgl2") !== null;
})()

回傳 false 表示無法建立 WebGL2 上下文。

也可造訪 WebGL Report（需可存取外網）查看詳細能力。

與 OffscreenCanvas 的關係

紋理壓縮 Worker 路徑也需要 OffscreenCanvas + WebGL2。若僅底部黃色 Worker 警告而預覽正常，優先查 OffscreenCanvas 指南；若預覽本身失敗，以本文為主。

小結

WebGL2 不可用核心是 GPU/驅動/硬體加速 問題，企業 VDI、遠端桌面、舊 WebView 也很常見。依平台開啟加速、更新驅動、本機瀏覽器存取，多數可恢復 3D 預覽。