如何修复 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 发起的签名请求。

常见问题解答

问：安装 Snap 是否需要所选网络上的 ETH 余额？不会。Snap 安装是客户端操作，不会产生任何链上交易或 Gas 消耗。

问：我可以同时安装多个 Snap 吗？可以，但一次只有一个 Snap 可以持有有效的交易签名权限；重叠的权限会触发先前授予的自动撤销。

问：为什么 Snap 在隐身模式下安装成功，但在常规浏览模式下安装失败？这表明来自持久浏览器扩展或在主配置文件下注册的缓存服务工作人员的干扰 - 禁用除 MetaMask 之外的所有扩展，并通过 DevTools 中的应用程序 → 服务工作人员清除服务工作人员。

问：本地安装的 Snap 有大小限制吗？是的。捆绑的 JavaScript 必须小于5 MB ；超出此范围会立即拒绝，并在弹出 UI 中显示“捆绑包太大”。