Any3DAny3D
·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 требует ручного включения через флаг; старые версии Safari
Операционная система не поддерживаетУстаревшие сборки Windows 10, не обновлённые macOS/iOS
Драйвер видеокарты слишком старыйОсобенно для встроенных Intel, Linux с низкой версией Mesa
Корпоративный/экспериментальный переключатель отключёнПолитика запрещает WebGPU или «экспериментальные графические функции»
Виртуальная машина / RDPОтсутствует виртуализация GPU
Расширения или инструменты конфиденциальностиПерехватывают navigator.gpu (редко)

Проверка по платформам

Windows

  1. Chrome 113+ / Edge 113+: откройте chrome://gpu в адресной строке и убедитесь, что статус WebGPU — Hardware accelerated или Available.
  2. В старых версиях может потребоваться chrome://flags/#enable-unsafe-webgpu (в новых версиях он включён по умолчанию, ручная активация не требуется).
  3. Обновите Windows 10/11 и драйверы видеокарты; WebGPU зависит от более новых стеков DXGI/D3D12.
  4. Групповые политики: в организациях может быть отключена «Экспериментальная платформа Web».
  5. RDP / Hyper-V виртуальные машины: обычно не поддерживают WebGPU, проверяйте на локальном физическом устройстве.

macOS

  1. Safari 17+ (macOS Sonoma и выше) или Chrome последней версии.
  2. Apple Silicon поддерживается хорошо; на Intel Mac требуются более новые версии macOS и драйверов.
  3. Ограничения MDM для «бета-функций» могут влиять на переключатель WebGPU.

Linux

  1. Chrome последней версии + Mesa 22+ или драйверы NVIDIA 525+.
  2. Поддержка Vulkan — часто обязательное условие: можно быстро проверить через vulkaninfo (для продвинутых пользователей).

iOS / iPadOS

  1. Safari 17+ (iOS 17+) обеспечивает постепенное развитие поддержки WebGPU.
  2. Требуется обновление системы; на управляемых устройствах администраторы могут откладывать обновления.
  3. Chrome на iOS использует WebKit, поэтому возможности совпадают с Safari.

Android

  1. Chrome 121+ включает WebGPU по умолчанию на некоторых устройствах; на бюджетных моделях он может быть недоступен.
  2. Обновите Chrome и системный WebView; при устаревшем GPU браузер может молча переключаться на fallback.

Сеть, VPN и корпоративная сеть

WebGPU — это локальный API, не блокируется напрямую VPN. Непрямые ситуации:

СценарийОписание
Корпоративный образ браузераКастомизированный Chromium может быть собран с отключённым WebGPU
Внутренняя сеть разрешает только старый EdgeWebGPU отсутствует, необходимо обновление через IT-отдел
Клиент Zero TrustРедко изменяет navigator.gpu; при подозрении проверьте в режиме инкогнито

Родительский контроль и управляемые устройства

  • Запрет обновлений системы/браузера → WebGPU будет недоступен долго, достаточно разрешить автоматические обновления.
  • Детские профили обычно не запрещают WebGPU; если используется упрощённый браузер, переключитесь на Chrome/Safari.

Пошаговое исправление (общее)

  1. Обновите операционную систему + браузер + драйверы видеокарты.
  2. Проверьте запись WebGPU в chrome://gpu; следуйте инструкциям по обновлению или включению.
  3. Запускайте на локальном физическом устройстве, а не через RDP/VDI.
  4. Используйте окно инкогнито для исключения влияния расширений.

Быстрая самопроверка

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, а инструменты работают нормально, можно пока игнорировать, но рекомендуется поддерживать систему и браузер в актуальном состоянии для лучшей производительности.

Поддержите нас