·Any3D Team
WebGPU 不可用？按平台與環境排查
troubleshootingbrowser-compatibilitywebgpu
你看到的症狀
Any3D 或瀏覽器環境檢測提示 WebGPU 不可用。說明：navigator.gpu 不存在，或無法取得 GPU 適配器（adapter）。
重要：Any3D 目前 3D 預覽以 WebGL2 為主；WebGPU 缺失通常不會單獨阻斷預覽與轉換主流程。本文供完整環境排查與未來特性參考。若預覽失敗，請優先查看 WebGL2 修復指南。
WebGPU 是什麼
WebGPU 是下一代瀏覽器圖形/運算 API，Chrome、Edge、Safari 等正在逐步預設啟用。Any3D 會偵測並回報 WebGPU 能力用於診斷，部分實驗性功能可能在未来依賴它。
常見原因
| 原因 | 典型場景 |
|---|---|
| 瀏覽器未啟用 WebGPU | Chrome < 113 需手動 flag；舊版 Safari |
| 作業系統不支援 | 舊 Windows 10 組建、未更新 macOS/iOS |
| 顯卡驅動過舊 | 尤其 Intel 集顯、Linux Mesa 版本低 |
| 企業/實驗開關被停用 | 策略禁用 WebGPU 或「圖形實驗特性」 |
| 虛擬機 / RDP | 無 GPU 虛擬化 |
| 擴充套件或隱私工具 | 攔截 navigator.gpu（少見） |
按平台排查
Windows
- Chrome 113+ / Edge 113+：網址列打開
chrome://gpu，確認 WebGPU 狀態為 Hardware accelerated 或 Available。 - 舊版需
chrome://flags/#enable-unsafe-webgpu（新版多數已預設，無需手動開）。 - 更新 Windows 10/11 與顯卡驅動；WebGPU 依賴較新的 DXGI/D3D12 架構。
- 群組原則：企業可能禁用「實驗性 Web 平台功能」。
- RDP / Hyper-V 虛擬機：常無 WebGPU，請在本地實體機測試。
macOS
- Safari 17+（macOS Sonoma+）或 Chrome 最新版。
- Apple Silicon 支援較好；Intel Mac 需較新 macOS 與驅動。
- MDM 限制「Beta 功能」時可能影響 WebGPU 實驗開關。
Linux
- Chrome 最新版 + Mesa 22+ 或 NVIDIA 驅動 525+。
- Vulkan 支援是常見前提：
vulkaninfo可快速檢查（進階使用者）。
iOS / iPadOS
- Safari 17+（iOS 17+）起 WebGPU 支援逐步完善。
- 系統需更新；受管理裝置可能被管理員延遲更新。
- Chrome on iOS 使用 WebKit，與 Safari 能力一致。
Android
- Chrome 121+ 在部分裝置上預設 WebGPU；低階機型可能仍不可用。
- 更新 Chrome 與系統 WebView；GPU 過舊時瀏覽器會靜默降級。
網路、VPN 與企業內網
WebGPU 為本地 API，不受 VPN 直接阻斷。間接情況：
| 場景 | 說明 |
|---|---|
| 企業瀏覽器鏡像 | 定製 Chromium 可能編譯時關閉 WebGPU |
| 內網只允許舊版 Edge | 無 WebGPU，需 IT 推送新版本 |
| 零信任用戶端 | 極少修改 navigator.gpu；若懷疑，無痕模式對比 |
家長控制與管理
- 禁止系統/瀏覽器更新 → WebGPU 長期不可用，允許自動更新即可。
- 兒童設定檔 一般不禁 WebGPU；若使用極簡瀏覽器，請換成 Chrome/Safari。
分步修復（通用）
- 更新 作業系統 + 瀏覽器 + 顯卡驅動。
chrome://gpu查看 WebGPU 項目；按提示更新或啟用。- 在實體機本地運行，勿使用 RDP/VDI。
- 開無痕視窗排除擴充套件。
快速自測
typeof navigator.gpu !== "undefined"
非同步檢測適配器（Console）：
navigator.gpu?.requestAdapter().then((a) => console.log(a ? "adapter ok" : "no adapter"));
no adapter 常見於驅動過舊、虛擬機或無相容 GPU。
與 Any3D 功能的關係
| 能力 | WebGPU 缺失時 |
|---|---|
| 3D 預覽（WebGL2） | 通常不受影響 |
| 格式轉換 / WASM 壓縮 | 不受影響 |
| 未來 WebGPU 加速特性 | 可能不可用 |
小結
WebGPU 不可用多為 系統/瀏覽器/驅動過舊、虛擬機、企業鎖定舊瀏覽器。Any3D 核心功能依賴 WebGL2 與 WASM；若僅 WebGPU 告警而工具正常使用，可暫不處理，但建議保持系統和瀏覽器更新以獲得更好效能。