이 문서에서는 WebGPU가 Chrome 브라우저에서 작동하지 않거나 예상대로 작동하지 않는 이유를 설명하고 가능한 경우 문제를 해결하는 명확한 단계를 안내합니다.
navigator.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)
다음 중 하나가 원인일 수 있습니다. 다음 순서대로 확인해 보세요.
사용자가
chrome://settings/system에서 '가능한 경우 그래픽 가속 사용'을 사용 중지한 경우 WebGPU가 사용 중지됩니다. 설정이 사용 중지되어 있는지 확인했다가 다시 사용 설정합니다.이 플랫폼에서는 아직 WebGPU가 지원되지 않습니다.
chrome://flags/#enable-unsafe-webgpu플래그를 사용 설정하고 Chrome을 다시 시작할 수 있습니다. Linux 실험 지원의 경우chrome://flags/#enable-vulkan플래그도 사용 설정해야 합니다. 자세한 내용은 헤드리스 Chrome의 WebGPU 지원을 참고하세요.GPU 하드웨어가 구체적으로 차단 목록에 추가되었습니다.
chrome://gpu에 'WebGPU가 차단 목록 또는 명령줄을 통해 사용 중지되었습니다'라는 메시지가 표시되면chrome://flags/#enable-unsafe-webgpu플래그를 사용 설정하고 Chrome을 다시 시작하여 WebGPU 어댑터 차단 목록을 사용 중지할 수 있습니다.requestAdapter()에 전달된 옵션과 일치하는 GPU 어댑터가 없습니다. 다양한 옵션으로requestAdapter()를 호출해 보세요.WebGPU를 사용하려면 GPU (하드웨어 또는 소프트웨어 에뮬레이션)가 필요합니다.
chrome://gpu를 방문하여 Chrome에서 GPU를 감지하는지 확인할 수 있습니다.GPU 프로세스가 여러 번 비정상 종료되었습니다. 페이지를 새로고침하거나 Chrome을 다시 시작할 수 있습니다. 자세한 내용은 WebGPU 기기 손실 권장사항을 참고하세요.
WebGPU가 WebGL보다 느림
chrome://gpu를 열고 'WebGPU: Hardware accelerated'라고 표시되는지 확인합니다. 'WebGPU: 소프트웨어 전용, 하드웨어 가속 사용 불가'가 표시되면 GPU 드라이버를 업데이트해야 할 수 있습니다.WebGL 개념을 WebGPU로 직접 변환하면 WebGPU의 고유한 최적화를 최대한 활용하지 못할 수 있습니다. WebGL에서 WebGPU로를 확인하여 차이점에 대해 자세히 알아보세요.
Windows 관련 제한사항
Windows 기기에서 WebGPU를 사용할 때는 다음 제한사항에 유의하세요.
Chrome은 여러 GPU 어댑터를 동시에 사용하는 것을 지원하지 않습니다. issue chromium:329211593을 참고하세요.
Chrome은 항상 다른 Chrome 워크로드에 할당된 것과 동일한 GPU 어댑터를 사용합니다. 노트북의 경우 전력 사용 측면 (예: 절전)으로 인해 일반적으로 통합 그래픽 카드입니다. 즉,
powerPreference옵션은requestAdapter()를 호출할 때 아무런 영향을 미치지 않습니다.