·Any3D Team
Web Worker를 사용할 수 없나요? 플랫폼 및 환경별 해결 방법
troubleshootingbrowser-compatibilityweb-worker
나타나는 증상
Any3D 하단에 노란색 경고가 표시됩니다: 「현재 브라우저는 Web Worker를 지원하지 않습니다」. 미리보기는 여전히 작동할 수 있지만, 대용량 파일 처리 시 페이지가 쉽게 멈출 수 있으며, 텍스처 압축이나 이미지를 모델로 변환하는 등 Worker를 사용하는 경로가 활성화되지 않습니다.
Web Worker는 오래 걸리는 계산을 백그라운드 스레드에서 실행하게 합니다. Any3D의 텍스처 압축 및 일부 변환 프로세스는 Worker + OffscreenCanvas + createImageBitmap 세 가지 조합에 의존합니다.
일반적인 원인
| 원인 | 일반적인 상황 |
|---|---|
| 안전하지 않은 컨텍스트 | file:// 로 열기, 내부망 HTTP 페이지 (localhost 제외) |
| 오래된 브라우저 / WebView | 구버전 시스템 브라우저, 앱 내장 페이지 |
| CSP 제한 | 기업 포털 iframe, 제로 트러스트 클라이언트의 worker-src 주입 |
| 확장 프로그램 차단 | 프라이버시 플러그인이 Worker 또는 blob: URL 차단 |
| 네트워크 캐시 이상 | 프록시/VPN이 불완전한 Worker 스크립트 반환 |
| 디바이스 감시 | 관리 프로필로 백그라운드 스크립트 비활성화 |
플랫폼별 해결 방법
Windows
- 반드시 HTTPS (
https://any3d.cc) 로 접근해야 하며, 로컬 HTML 파일은 사용하지 마세요. - Edge 기업 정책:
Computer Configuration → Administrative Templates → Microsoft Edge에서 Worker 또는 타사 쿠키를 제한하는지 확인합니다 (일부 Worker 로드에 간접적 영향). - Windows 가족 안전: 하위 계정의 웹 제한으로 Worker 생성이 실패할 수 있습니다.
macOS
- Safari / Chrome 모두 macOS 12 이상 및 최신 버전의 브라우저가 필요합니다.
- 화면 사용 시간 → 콘텐츠 및 개인 정보 보호 → "성인 사이트 제한" 또는 사용자 지정 필터가 활성화되어 있으면, 실수로 Worker 스크립트 도메인을 차단할 수 있습니다.
- 기업 MDM 프로필이 "사이트 간 추적" 외의 스크립트 기능을 비활성화한 경우, IT 부서에 문의하세요.
Linux
- 접속 URL이 HTTPS인지 확인하세요. 기업 Squid 프록시는
blob:및worker-src관련 요청을 허용해야 합니다.
iOS / Android
- 절대 WeChat/DingTalk 내장 브라우저에서 대용량 파일 처리를 완료하지 마세요. 시스템 브라우저를 사용하여 열어주세요.
- iOS 저전력 모드는 일반적으로 Worker를 비활성화하지 않지만, 오래된 WebKit에는 API가 없을 수 있습니다. 시스템을 최신 상태로 유지하세요.
- Android WebView 버전이 오래된 경우 (시스템 WebView가 업데이트되지 않은 경우) Worker를 사용할 수 없게 됩니다: Play 스토어에서 "Android System WebView"를 업데이트하세요.
네트워크, VPN 및 기업 내부망
| 상황 | 설명 |
|---|---|
| 기업 VPN | 일부 VPN이 HTTPS 디코딩을 강제하고 CSP를 주입하여, IT 부서가 Worker를 허용하도록 설정해야 할 수 있습니다 |
| 내부망 SSO 포털 iframe | 외부 페이지 CSP가 worker-src blob: 를 금지할 수 있으므로, 내부 페이지가 별도로 설정하거나 새 탭에서 Any3D를 열어야 합니다 |
| 리버스 프록시 | Nginx/게이트웨이 구성 오류로 인해 Worker 스크립트 MIME 유형이 올바르지 않을 수 있습니다 |
| 부모 라우터 DNS 필터 | Worker에서는 드물지만, 전체 사이트가 HTTP 미러로 강등되면 Worker가 작동하지 않을 수 있습니다 |
자가 진단: VPN을 끄고 4G/5G 핫스팟으로 전환하여 경고가 사라지는지 확인하세요.
기업 CSP 참고 (IT 담당자용)
Any3D가 iframe으로 삽입된 경우, 다음을 허용하는 것이 좋습니다:
worker-src 'self' blob:;
script-src 'self' 'unsafe-eval' blob:;
개인 사용자는 수동으로 CSP를 변경할 필요가 없습니다.
단계별 해결 방법 (일반)
- HTTPS 접근을 확인하고 페이지를 새로고침합니다 (Ctrl+F5 / Cmd+Shift+R).
- 시크릿 창에서 확장 프로그램을 제외합니다.
- 브라우저와 (Android) 시스템 WebView를 업데이트합니다.
- 새 탭에서 Any3D를 직접 열어, 기업 포털 iframe 내부에 중첩되지 않도록 합니다.
빠른 자체 테스트
typeof Worker !== "undefined"
true가 반환되면 API가 존재한다는 것을 의미하지만, Any3D는 전체 Worker 경로를 사용하기 위해 OffscreenCanvas와 createImageBitmap도 모두 필요합니다.
Worker가 없을 때의 영향
| 기능 | 영향 |
|---|---|
| 버텍스 압축 (Draco 등) | 일반적으로 여전히 사용 가능 (메인 스레드 + WASM) |
| 텍스처 / KTX2 압축 | Worker 경로를 사용할 수 없으므로, 대용량 파일 처리 시 지연이 발생할 수 있음 |
| 이미지를 모델로 변환 | 성능이 저하되거나 크게 떨어질 수 있음 |
요약
Web Worker 경고는 주로 HTTPS 미사용, 오래된 WebView, 기업 CSP/VPN, 확장 프로그램 차단 으로 인해 발생합니다. 플랫폼에 따라 브라우저를 업데이트하고, 네트워크를 변경하여 확인하며, IT 부서에 iframe/CSP를 점검하도록 요청하면, 일반적으로 백그라운드 처리 기능을 복구할 수 있습니다.