·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 | 微信/釘釘內建瀏覽器、舊版 App 內嵌頁面 |
| 裝置監管設定 | 學校/公司託管裝置、螢幕使用時間類限制 |
依平台排查
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 核心） 中開啟，避免在 App 內 WebView 裡直接使用。
- 螢幕使用時間 → 內容與隱私限制：關閉「限制 Web 內容」或將 Any3D 加入允許清單。
- 企業 MDM 裝置可能停用部分 JavaScript 能力，需聯繫 IT。
Android（行動）
- 使用 Chrome 最新版；國產瀏覽器請切換到「極速/現代核心」，勿用相容模式。
- 數位健康 / 家長控制（Family Link 等）：檢查是否限制了瀏覽器或未知網站。
- 微信、釘釘內開啟 → 點右上角「在瀏覽器中開啟」。
網路、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 相容 / 雙核相容模式。
- 逐個停用擴充功能（廣告攔截、隱私、腳本類優先）。
快速自測
在開發者工具 Console 中執行：
typeof WebAssembly !== "undefined"
回傳 true 表示 WASM API 可用。若仍為 false，問題在瀏覽器或系統策略，而非 Any3D。
仍無法解決？
- 記錄：作業系統、瀏覽器版本、是否使用 VPN/內網、是否為託管裝置。
- 透過 Any3D 頁面回饋入口提交，附上上述資訊。
小結
WebAssembly 缺失常見於舊瀏覽器、擴充功能干擾、VPN/內網攔截、企業或家長策略限制。依平台逐項排除後，大多數環境可恢復。Any3D 無法在 WASM 不可用時降級——修復瀏覽器與存取環境是唯一可行方案。