如何修復 MetaMask snap 安裝失敗？

了解 MetaMask 快照故障模式

1. 當瀏覽器擴充版本低於 v10.24.0 時，Snaps 安裝失敗，因為舊版缺乏第三方模組的強制權限委託邏輯。

2. 衝突的瀏覽器擴充功能（尤其是 uBlock Origin 等廣告攔截器或 Privacy Badger 等隱私工具）會幹擾 Snap 清單取得和腳本注入。

3. 公司或 ISP 管理的環境中的網路層級過濾會阻止對https://registry.snapcraft.io 的訪問，從而在下載開始之前停止發現階段。

4. 與快照元資料相關的損壞的本機 IndexedDB 項目會導致簽章驗證在初始化期間靜默中止。

5. 作業系統時間偏差超過 ±60 秒會觸發快照登錄端點上的 TLS 憑證驗證失敗，導致「取得失敗」且沒有描述性錯誤代碼。

特定於瀏覽器的配置調整

1. 在 Chrome 中，導覽至chrome://flags/#enable-experimental-web-platform-features並啟用該標誌；之後重新啟動瀏覽器。

2. 對於 Firefox 用戶，在網址列中輸入about:config ，搜尋dom.webcomponents.customelements.enabled ，並將其設為true 。

3. Brave 要求在metamask.io的站點設定下完全停用 Shields，而不僅僅是降低保護等級。

4. Edge 使用者必須驗證Edge://settings/privacy中是否啟用了「允許網站檢查您是否安裝了擴充功能」。

5. 由於 WebKit 缺少WebAssembly.Global且Web Crypto API實作不完整，Safari 目前不支援 Snap 安裝。

手動快照註冊表繞過程序

1. 從目標 snap 的經過驗證的 GitHub 發布頁面（例如https://github.com/MetaMask/snaps/releases ）下載官方 Snap 捆綁包 ZIP。

2. 解壓縮dist/bundle.js檔案並開啟 MetaMask 設定 → 進階 → “顯示實驗功能” → 開啟「Snaps 開發者模式」。

3. 按一下“本機安裝 Snaps”，然後選擇解壓縮的bundle.js檔案－此階段不會發生網路呼叫。

4. 透過檢查顯示的權限來確認安裝：帳戶存取、交易簽名和網路切換都必須明確列出。

5. 如果 UI 顯示“無效清單格式”，請驗證 ZIP 包含有效的snaps.manifest.json以及正確的version 、 suggestName和description欄位。

節點級 RPC 幹擾緩解

1. 在 MetaMask 設定→網路→「編輯網路」→取消勾選「顯示測試網路」中暫時停用所有自訂 RPC，並刪除非預設鏈。

2. 將 MetaMask 切換到以太坊主網，並在重新嘗試安裝 Snap 之前確認交易歷史記錄正確載入。

3. 開啟 MetaMask 開發者工具（右鍵點選擴充圖示→「管理擴充」→「檢查檢視：popup.html」），然後在控制台中執行localStorage.removeItem('rpcCache')來清除快取的 RPC 回應。

4. 在 Snap 設定過程中避免使用基於 Infura 的 RPC；相反，依賴 MetaMask 的內建後備節點，該節點強制執行與 Snap 沙箱相容的更嚴格的 CORS 標頭。

5. 如果使用硬體錢包，請確保韌體更新至 v2.5.2 或更高版本 - 舊版因 EIP-712 網域分隔符號格式錯誤而拒絕 Snap 發起的簽章要求。

常見問題解答

Q：安裝 Snap 是否需要所選網路上的 ETH 餘額？不會。 Snap 安裝是客戶端操作，不會產生任何鏈上交易或 Gas 消耗。

Q：我可以同時安裝多個 Snap 嗎？可以，但一次只有一個 Snap 可以持有有效的交易簽名權限；重疊的權限會觸發先前授予的自動撤銷。

Q：為什麼 Snap 在隱身模式下安裝成功，但在常規瀏覽模式下安裝失敗？這表明來自持久瀏覽器擴展或在主配置文件下註冊的快取服務工作人員的干擾 - 禁用除 MetaMask 之外的所有擴展，並透過 DevTools 中的應用程式 → 服務工作人員清除服務工作人員。

Q：本地安裝的 Snap 有大小限制嗎？是的。捆綁的 JavaScript 必須小於5 MB ；超出此範圍會立即拒絕，並在彈出 UI 中顯示「捆綁包太大」。