·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 告警而工具正常使用，可暂不处理，但建议保持系统和浏览器更新以便获得更好性能。