WebGL2 사용 불가? 플랫폼별 3D 미리보기 문제 해결
문제 증상
미리보기 영역에 '3D 미리보기 사용 불가'가 표시되거나 페이지가 비어 있고 모델이 표시되지 않습니다. Any3D의 온라인 미리보기는 GPU에서 3D 장면을 렌더링하기 위해 WebGL2에 의존합니다. WebGL2를 사용할 수 없으면 미리보기를 시작할 수 없습니다.
일반적인 원인
| 원인 | 일반적인 상황 |
|---|---|
| 하드웨어 가속 비활성화 | 브라우저 또는 시스템 설정에서 GPU 비활성화 |
| 그래픽 드라이버 오래됨/이상 | Windows 노트북 듀얼 GPU, Linux 오픈소스 드라이버 |
| 브라우저 블랙리스트 | 매우 오래된 GPU가 브라우저의 소프트웨어 렌더링 목록에 포함 |
| 원격 데스크톱/가상 머신 | RDP, VM에서 GPU 패스스루 없음 |
| 기업 정책 | GPO에서 하드웨어 가속 비활성화, VDI에서 3D 가속 없음 |
| WebView/오래된 코어 | WeChat, DingTalk, 오래된 앱 |
| 확장 프로그램 간섭 | Canvas 지문 보호 유형 플러그인 강제 사용 |
플랫폼별 문제 해결
Windows
-
하드웨어 가속 활성화 Chrome/Edge: 설정 → 시스템 → '가능한 경우 하드웨어 가속 사용' → 브라우저 재시작.
-
그래픽 드라이버 업데이트 NVIDIA / AMD / Intel 공식 웹사이트 또는 Windows Update에서 최신 드라이버 설치. 노트북의 그래픽 제어판에서 브라우저를 '고성능'으로 설정.
-
그룹 정책/레지스트리 (기업용) IT 관리자가 정책을 통해 GPU 합성을 비활성화했을 수 있습니다. 개인 사용자는
chrome://gpu에서 많은 'Software only'가 있는지 확인합니다. -
원격 데스크톱 RDP를 통해 사무실 PC에 연결할 때 WebGL은 종종 사용 불가입니다. 로컬 PC 브라우저에서 Any3D를 열거나 GPU를 지원하는 원격 솔루션을 사용하세요.
-
부모 제어 Windows 패밀리 안전 하위 계정은 일반적으로 WebGL을 비활성화하지 않습니다. '어린이 브라우저'를 사용하는 경우 Chrome/Edge로 테스트해 보세요.
macOS
- Safari / Chrome 최신 버전; 시스템 설정 → 디스플레이 → 주사율/해상도가 정상인지 확인.
- 저전력 모드에서는 GPU가 클록 다운되어 극단적인 경우 WebGL에 영향을 줄 수 있습니다. 전원을 연결하고 다시 시도하세요.
- 화면 시간은 WebGL을 직접 비활성화하지 않습니다. MDM이 그래픽을 제한하는 경우 IT 부서에 문의하세요.
Linux
- 독점 드라이버 (NVIDIA) 또는 최신 Mesa;
chrome://gpu에서 GL 상태를 확인합니다. - Wayland와 X11 중 하나가 실패하면 세션을 전환하여 비교합니다.
iOS / iPadOS
- Safari는 WebGL2 지원이 좋습니다. 시스템을 업데이트 상태로 유지하세요.
- 저전력 모드는 성능을 제한할 수 있어 미리보기가 끊기거나 실패할 수 있습니다. 충전 후 다시 시도하세요.
- 앱 내 WebView → Safari에서 열기.
- 학교에서 관리하는 iPad에서 '카메라/파일'을 금지해도 WebGL에는 영향을 미치지 않지만, 시스템 업데이트를 금지하면 코어가 너무 오래될 수 있습니다.
Android
- Chrome을 업데이트하고 개발자 옵션 → GPU 렌더링 강제를 활성화합니다 (일부 오래된 기기에서는 효과적이지만, 새로운 시스템에서는 이미 기본값일 수 있습니다).
- 중국 브라우저의 호환 코어는 종종 WebGL2를 지원하지 않습니다 → Chrome을 사용하세요.
- 절전 모드는 GPU를 제한합니다 → 비활성화 후 다시 시도하세요.
네트워크, VPN 및 기업 인트라넷
WebGL2는 로컬 GPU API로, 일반적으로 VPN의 직접적인 영향을 받지 않습니다. 하지만 다음 상황에 주의가 필요합니다:
| 상황 | 설명 |
|---|---|
| 기업 VDI (Citrix/VMware) | GPU 패스스루가 활성화되지 않으면 WebGL을 사용할 수 없으며, IT가 vGPU를 활성화하거나 로컬 브라우저를 사용해야 합니다 |
| VPN이 브라우저 확장 프로그램을 강제 설치 | 확장 프로그램이 WebGL 컨텍스트를 방해할 수 있습니다 |
| 인트라넷에서 IE/오래된 Edge만 허용 | WebGL2를 지원하지 않으므로 최신 Chromium 브라우저를 사용해야 합니다 |
부모 제어 및 공공 환경
- 도서관/학교 PC: 브라우저가 잠겨 있거나 전용 그래픽 카드가 없을 수 있습니다. 개인 노트북으로 확인하세요.
- Family Link의 Chrome 버전 제한: Play 스토어에서 Chrome 업데이트를 허용하세요.
단계별 해결 방법 (일반)
chrome://gpu(Chrome/Edge) 또는about:support→ 그래픽을 열어 WebGL2가 하드웨어 가속 상태인지 확인합니다.- 하드웨어 가속을 활성화하고, 드라이버를 업데이트하며, 브라우저와 시스템을 재시작합니다.
- 시크릿 창에서 확장 프로그램을 제외합니다.
- 브라우저를 변경하거나 기기를 변경하여 교차 확인합니다.
빠른 자체 테스트
(() => {
const c = document.createElement("canvas");
return c.getContext("webgl2") !== null;
})()
반환값이 false이면 WebGL2 컨텍스트를 생성할 수 없음을 의미합니다.
WebGL Report (외부 네트워크 액세스 필요)에 접속하여 자세한 기능을 확인할 수도 있습니다.
OffscreenCanvas와의 관계
텍스처 압축 Worker 경로도 OffscreenCanvas + WebGL2가 필요합니다. 하단의 노란색 Worker 경고만 있고 미리보기가 정상인 경우, OffscreenCanvas 가이드를 먼저 확인하세요. 미리보기가 자체적으로 실패하는 경우 본 문서를 참고하세요.
요약
WebGL2를 사용할 수 없는 핵심은 GPU/드라이버/하드웨어 가속 문제이며, 기업 VDI, 원격 데스크톱, 오래된 WebView에서도 흔히 발생합니다. 플랫폼별로 가속을 활성화하고, 드라이버를 업데이트하며, 로컬 브라우저로 액세스하면 대부분 3D 미리보기를 복구할 수 있습니다.