이 문서에서는 Chrome 브라우저에서 WebGPU가 제대로 작동하지 않거나 예상대로 작동하지 않는 이유를 설명하고 가능한 경우 문제를 해결하기 위한 명확한 단계를 안내합니다.
navgator.gpu가 정의되지 않음
다음 예는 navigator
에서 gpu
를 사용할 수 없을 때 발생할 수 있는 JavaScript 오류를 보여줍니다.
const adapter = await navigator.gpu.requestAdapter();
cancel Uncaught TypeError: Cannot read properties of undefined (reading 'requestAdapter')
다음 이유 중 하나가 원인일 수 있습니다. 이 순서대로 체크해 보세요.
WebGPU를 사용하려면 ChromeOS, macOS, Windows에서 Chrome 113 이상이 필요하며 Android에서는 Chrome 121 이상이 필요합니다.
chrome://version
에서 버전을 확인하고 필요한 경우 업데이트하세요.WebGPU는 보안 컨텍스트에서만 액세스할 수 있습니다. 안전하지 않은 프로토콜 (예:
http:
,file:
)을 통해 코드를 제공하는 경우 보안https:
프로토콜을 사용하거나 웹 앱을 개발하는 동안 다음 방법 중 하나로 문제를 해결하세요.npx http-server
또는python3 -m http.server
명령어 중 하나를 사용하여http://localhost
또는http://127.0.0.1
에 로컬로 코드를 제공합니다.'안전하지 않은 출처가 안전한 것으로 취급됨'에 출처를 추가합니다.
chrome://flags/#unsafely-treat-insecure-origin-as-secure
목록을 열고 Chrome을 다시 시작하세요.Node.js를 설치하고
npx servez --ssl
를 실행하여 가짜 인증서로 HTTPS를 통해 폴더를 제공합니다. Chrome에 경고가 계속 표시되며 '고급'을 클릭하면 우회할 수 있습니다. '계속 진행'을 선택합니다.ngrok를 사용하여 로컬 웹 서버를 인터넷에 노출합니다.
GPU 어댑터가 null입니다.
다음은 requestAdapter()
를 호출하여 가져오는 어댑터가 null일 때 발생할 수 있는 JavaScript 오류의 예입니다.
const adapter = await navigator.gpu.requestAdapter();
const device = await adapter.requestDevice();
cancel Uncaught TypeError: Cannot read properties of undefined (reading requestDevice)
이는 다음 이유 중 하나로 인해 발생합니다. 이 순서대로 체크해 보세요.
사용자가 '가능한 경우 그래픽 가속 사용'을 사용 중지하면 WebGPU가 사용 중지됩니다.
chrome://settings/system
. 설정이 사용 중지되어 있는지 확인했다가 다시 사용 설정합니다.이 플랫폼에서는 아직 WebGPU가 지원되지 않습니다.
chrome://flags/#enable-unsafe-webgpu
플래그를 사용 설정하고 Chrome을 다시 시작할 수 있습니다. Linux 실험용 지원의 경우chrome://flags/#enable-vulkan
플래그도 사용 설정해야 합니다. 자세한 내용은 헤드리스 Chrome의 WebGPU 지원을 확인하세요.GPU 하드웨어가 구체적으로 차단 목록에 포함되었습니다. 'WebGPU has been disabled via blocklist or the 명령줄(차단 목록 또는 명령줄을 통해 WebGPU가 사용 중지됨)'이 표시되는 경우
chrome://gpu
에서chrome://flags/#enable-unsafe-webgpu
플래그를 사용 설정하고 Chrome을 다시 시작하여 WebGPU 어댑터 차단 목록을 사용 중지할 수 있습니다.requestAdapter()
에 전달된 옵션과 일치하는 GPU 어댑터가 없습니다. 다른 옵션으로requestAdapter()
에 전화를 걸어보세요.WebGPU에는 GPU (하드웨어 또는 소프트웨어 에뮬레이션)가 필요합니다.
chrome://gpu
를 방문하여 Chrome에서 GPU를 감지하는지 확인할 수 있습니다.
WebGPU가 WebGL보다 느림
chrome://gpu
을 열고 'WebGPU: Hardware accelerated'를 읽을 수 있는지 확인합니다. 'WebGPU: 소프트웨어만, 하드웨어 가속을 사용할 수 없음'이라고 표시되는 경우 GPU 드라이버를 업데이트해야 할 수 있습니다.WebGL 개념을 WebGPU로 직접 변환하면 WebGPU의 고유한 최적화를 최대한 활용하지 못할 수 있습니다. 차이점에 관해 알아보려면 WebGL에서 WebGPU까지를 참고하세요.
Windows 관련 제한사항
Windows 기기에서 WebGPU를 사용할 때는 다음 제한사항에 유의하세요.
Chrome에서는 여러 GPU 어댑터의 동시 사용을 지원하지 않습니다. 문제 chromium:329211593을 참고하세요.
Chrome은 항상 다른 Chrome 워크로드에 할당된 것과 동일한 GPU 어댑터를 사용합니다. 노트북의 경우 전력 사용 측면 (예: 절전)으로 인해 일반적으로 통합 그래픽 카드입니다. 즉,
requestAdapter()
를 호출할 때powerPreference
옵션은 아무런 영향을 미치지 않습니다.