·Any3D Team
WebAssembly를 사용할 수 없나요? 플랫폼과 환경별로 문제 해결하기
troubleshootingbrowser-compatibilitywebassembly
보이는 증상
모델을 업로드하면 Any3D에서 '현재 브라우저는 WebAssembly를 지원하지 않습니다'라는 메시지가 표시되며, 형식 변환, Draco 압축 해제, KTX2 텍스처 압축 등의 작업을 계속할 수 없습니다.
WebAssembly(WASM)는 브라우저에서 고성능 코드를 실행하는 기반입니다. Any3D의 Draco, MeshOpt, IFC/STEP 파싱, KTX2 인코딩 등 모듈은 모두 이를 의존합니다. WASM가 없으면 주요 흐름이 바로 차단됩니다.
흔한 원인
| 원인 | 전형적인 상황 |
|---|---|
| 브라우저 버전이 오래됨 | 기업 내부 네트워크에서 오랫동안 업데이트되지 않은 Chrome, IE 호환 모드 |
| 보안 정책이 WASM 사용을 비활성화함 | 회사 GPO/MDM, 부모 제어, 국산 브라우저의 '호환 코어' |
| 확장 프로그램 또는 스크립트가 차단함 | 광고 차단, 개인정보 보호 플러그인이 .wasm 리소스를 실수로 차단 |
| 네트워크 중간 계층 간섭 | 회사 VPN, 투명 프록시, 내부 네트워크 게이트웨이가 WASM 파일을 재작성하거나 차단 |
| 비표준 WebView | WeChat/DingTalk 내장 브라우저, 오래된 앱 내 임베디드 페이지 |
| 장치 관리 구성 | 학교/회사에서 관리하는 장치, 화면 시간 같은 제한 |
플랫폼별 문제 해결
Windows(데스크톱)
- Chrome / Edge 최신 안정 빌드(90 이상 권장)를 사용하고, IE 모드 또는 '호환 보기를 피하세요.
chrome://settings/system에서 하드웨어 가속이 활성화되어 있는지 확인하세요(GPU 스택 관련이며, 일부 환경에서는 WASM 로드에도 영향을 줄 수 있습니다).- 그룹 정책(기업): IT 관리자가 'JavaScript 비활성화' 또는 Web 기능을 제한한 경우 WASM도 함께 작동하지 않게 됩니다. 관리자에게
wasm-unsafe-eval또는 동등한 정책을 허용하는지 확인하세요. - Windows 가족 안전 / 부모 제어: 계정이 '자녀 계정'이고 브라우저 기능을 제한한 경우, 관리자 계정으로 전환하거나 'Web 탐색 제한'을 조정한 후 다시 시도하세요.
macOS(데스크톱)
- Safari 15+ 또는 Chrome / Firefox 최신 빌드를 우선 사용하세요.
- 화면 시간(Screen Time): 콘텐츠 제한 → 웹 콘텐츠가 '허용된 웹사이트만'으로 설정된 경우, 스크립트 실행 환경을 간접적으로 제한할 수 있습니다.
- MDM 관리 Mac(회사에서 제공한 장치): 프로필이 브라우저 확장이나 Web 기능을 제한하는지 확인하세요.
Linux(데스크톱)
- 배포판 공식 채널 또는 브라우저 공식 웹사이트에서 설치한 Chrome / Firefox를 사용하고, 오래된 Snap/Flatpak 패키지 버전을 피하세요.
- 기업 내부 네트워크 Linux 워크스테이션이 HTTP 프록시를 강제 사용하는 경우, 프록시가
.wasm의Content-Type: application/wasm을 차단하지 않는지 확인하세요.
iOS / iPadOS(모바일)
- Safari 또는 **Chrome(iOS는 실제로 WebKit 기반)**에서 열고, 앱 내 WebView에서 직접 사용하지 마세요.
- 화면 시간 → 콘텐츠 및 개인정보 보호 제한: 'Web 콘텐츠 제한'을 비활성화하거나 Any3D를 허용 목록에 추가하세요.
- 기업 MDM 장치는 일부 JavaScript 기능을 비활성화할 수 있으므로 IT 부서에 문의하세요.
Android(모바일)
- Chrome 최신 빌드를 사용하세요; 국산 브라우저는 '빠르기/최신 코어'로 전환하고 호환 모드를 사용하지 마세요.
- 디지털 웰빙 / 부모 제어(Family Link 등): 브라우저 또는 알 수 없는 사이트를 제한하는지 확인하세요.
- WeChat, DingTalk에서 열기 → 오른쪽 상단의 '브라우저에서 열기'를 클릭하세요.
네트워크, VPN 및 기업 내부 네트워크
| 상황 | 권장 조치 |
|---|---|
| 회사 VPN | VPN을 끄고 비교 테스트; 일부 VPN은 MITM 또는 정적 리소스를 캐시하여 WASM 검증 실패를 초래함 |
| 내부 네트워크 프록시 / 투명 게이트웨이 | IT에 *.wasm이 차단되지 않는지 확인 요청; 필요 시 Any3D 도메인을 화이트리스트에 추가 |
| 해외 노드 / 분산 규칙 | Any3D 정적 리소스가 직접 연결 또는 안정적인 경로를 사용하도록 보장; CDN 노드가 잘못된 MIME을 반환하지 않도록 함 |
| 제로 트러스트 클라이언트(ZTA) | 일부 클라이언트가 CSP를 주입하므로 wasm-unsafe-eval을 허용해야 함 |
개인 사용자: 모바일 핫스팟이나 가정 네트워크로 교차 테스트하면 네트워크 계층 문제인지 빠르게 판단할 수 있습니다.
부모 제어 및 장치 관리
- Microsoft Family Safety / Google Family Link / Apple 화면 시간: '웹사이트 필터링', '승인된 앱만 허용' 설정이 완전한 Web 기능을 차단하는지 확인하세요.
- 학교/도서관 공용 컴퓨터: Deep Freeze나 최소 브라우저 구성이 자주 활성화되어 있으므로 개인 장치를 사용하는 것이 좋습니다.
- 기업 Intune / Jamf 관리: 브라우저가 오래된 버전으로 고정되거나 확장 프로그램 이외의 스크립트 기능이 비활성화될 수 있으므로, IT에 예외를 요청하거나 관리되지 않는 브라우저 프로필을 사용하세요.
단계별 해결(범용)
- 시크릿/프라이버시 창에서 다시 시도(확장 프로그램 배제).
- 브라우저를 최신 안정 빌드로 업데이트하고 다시 시작합니다.
- 다른 브라우저로 교차 검증: Chrome ↔ Edge ↔ Firefox ↔ Safari.
- IE 호환 / 듀얼 코어 호환 모드를 비활성화합니다.
- 확장 프로그램을 하나씩 비활성화(광고 차단, 개인정보 보호, 스크립트 관련을 우선).
빠른 자체 테스트
개발자 도구 콘솔에서 다음을 실행합니다.
typeof WebAssembly !== "undefined"
true가 반환되면 WASM API를 사용할 수 있는 것입니다. 여전히 false가 반환되면 문제가 브라우저나 시스템 정책에 있는 것이지 Any3D에 있는 것이 아닙니다.
여전히 해결되지 않는 경우?
- 다음 정보를 기록하세요: 운영 체제, 브라우저 버전, VPN/_INTRAnet 사용 여부, 관리 장치 여부.
- Any3D 페이지의 피드백 제출 양식을 사용하여 위 정보를 첨부하여 제출하세요.
요약
WebAssembly 부재는 오래된 브라우저, 확장 프로그램 간섭, VPN/INTRAnet 차단, 기업 또는 부모 정책 제한 등에서 흔히 발생합니다. 플랫폼별로 항목을 하나씩 배제하면 대부분의 환경에서 복구할 수 있습니다. Any3D는 WASM를 사용할 수 없을 때 저하 모드로 전환할 수 없으므로, 브라우저와 접속 환경을 수정하는 것이 유일한 실용적인 해결책입니다.