WebGL2 不可用？3D 預覽排查指南
你看到的症狀
Any3D 首頁或工具頁中，3D 預覽區域出現錯誤提示：「無法建立 WebGL2 上下文」或「3D 預覽在您的瀏覽器中不可用」，畫布黑畫面、模型無法載入旋轉。
Any3D 核心預覽依賴 WebGL2。如果 WebGL2 無法啟用，3D 預覽將完全無法工作。
常見原因速查
| 原因 | 典型場景 |
|---|---|
| 硬體加速未開啟 | 瀏覽器設定中關閉了硬體加速 |
| 顯示卡驅動程式過舊／損毀 | Windows Update 後驅動異常，或很久未更新 |
| 遠端桌面／虛擬機器 | Windows 遠端桌面 (RDP)、無 GPU 的虛擬機器 |
| 瀏覽器黑名單 | 舊顯示卡被瀏覽器列入 WebGL 不支援名單 |
| 雙顯示卡切換異常 | 筆電未調用獨立顯示卡，內建顯示卡驅動崩潰 |
| 企業 VDI 環境 | 雲端桌面未配置 vGPU 虛擬化 |
按平台排查
Windows
-
開啟硬體加速
Chrome／Edge：設定 → 系統 →「開啟硬體加速（如可用）」→ 重新啟動瀏覽器。 -
更新顯示卡驅動程式
到 NVIDIA／AMD／Intel 官網或透過 Windows Update 安裝最新驅動。筆電請在顯示卡控制面板中，將瀏覽器設為「高效能」。 -
群組原則／登錄檔（企業）
IT 可能透過原則停用 GPU 合成。一般使用者可檢查chrome://gpu是否出現大量「Software only（僅軟體算繪）」。 -
遠端桌面
用 RDP 連回辦公電腦時，WebGL 常常無法使用——請用本機電腦的瀏覽器開啟 Any3D，或改用支援 GPU 的遠端方案。 -
家長監護
Windows 家長監護的子帳戶通常不會停用 WebGL；但若使用第三方「兒童瀏覽器」，請改用 Chrome／Edge 測試。
macOS
- 請將 Safari／Chrome 更新到最新版；系統設定 → 顯示器 → 更新率／解析度正常即可。
- 低耗電模式下 GPU 會降頻，極端情況會影響 WebGL——插電重試。
- 螢幕使用時間不會直接停用 WebGL；若 MDM 限制圖形功能，需聯絡 IT。
Linux
- 使用 NVIDIA 專有驅動程式或較新的 Mesa；在
chrome://gpu查看 GL 狀態。 - Wayland 與 X11 若某一邊失敗，可切換工作階段比對。
iOS / iPadOS
- Safari 對 WebGL2 支援較好；請保持系統更新。
- 低耗電模式可能限制效能，導致預覽卡頓或失敗——充電後再試。
- App 內嵌 WebView → 改用 Safari 開啟。
- 學校託管 iPad 若禁止系統更新，可能導致核心過舊。
Android
- 更新 Chrome；開啟 開發者人員選項 → 強制 GPU 算繪（部分舊機型有效）。
- 第三方瀏覽器相容核心常無 WebGL2 → 改用 Chrome。
- 省電模式限制 GPU——關閉後重試。
網路、VPN 與企業內部網路
WebGL2 為本機 GPU API，通常不受 VPN 直接影響。但以下情況需留意：
| 場景 | 說明 |
|---|---|
| 企業 VDI（Citrix/VMware） | 未啟用 GPU 直通時 WebGL 不可用，需 IT 開啟 vGPU 或使用本機瀏覽器 |
| VPN 強制安裝瀏覽器擴充功能 | 擴充功能可能干擾 WebGL 上下文 |
| 內部網路僅允許舊版瀏覽器 | 無 WebGL2，必須更換為現代 Chromium 瀏覽器 |
家長控制與公共環境
- 圖書館／學校 PC：可能使用鎖定版瀏覽器或無獨立顯示卡——換用個人筆電驗證。
- Family Link 限制 Chrome 版本：允許 Play 商店更新 Chrome。
分步修復（通用）
- 開啟
chrome://gpu（Chrome/Edge）或about:support→ 圖形，確認 WebGL2 是否為 Hardware accelerated。 - 開啟硬體加速，更新驅動程式，重新啟動瀏覽器與系統。
- 使用無痕視窗排除擴充功能干擾。
- 更換瀏覽器／更換裝置進行交叉驗證。
快速自我檢測
(() => {
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 預覽。