如何修復 MetaMask 在 dApp 上顯示「不支援鏈」的問題？

了解鏈條不支援錯誤

1. 當 dApp 嘗試與目前未在 MetaMask 的活動網路清單中配置的區塊鏈網路進行互動時，會發生此錯誤。

2. 這種情況通常發生在新的第 2 層匯總或自訂測試網的早期測試期間，其中尚未手動添加鏈 ID、RPC URL 或區塊瀏覽器 URL。

3. MetaMask 根據其內部註冊表驗證每個鏈；無法識別的鏈會立即觸發拒絕，而無需後備邏輯。

4. 一些 dApp 嵌入了與使用者選擇的網路衝突的硬編碼鏈參數，即使似乎選擇了正確的鏈，也會導致無聲的不匹配。

5. 瀏覽器快取可能會保留過時的鏈元數據，導致針對目前 dApp 要求的驗證檢查過時。

驗證網路配置

1. 開啟 MetaMask 設定並導覽至網路 → 新增網路 → 自訂 RPC。

2. 確認 Chain ID 與 dApp 文件指定的完全匹配 - 區分大小寫且僅包含數字（例如，8453​​ 表示 Base Mainnet，而不是「base」）。

3. 直接從 dApp 的開發者入口網站貼上官方 RPC 端點，而不是第三方聚合器或社群維護的清單。

4. 確保貨幣符號欄位使用鏈的代幣標準定義的確切代碼（例如，以太坊上的“ETH”，Polygon 上的“MATIC”，而不是“matic”或“Matic”）。

5. 交叉檢查區塊瀏覽器 URL 格式：它必須解析為在新分頁中開啟時顯示最近區塊的即時瀏覽器頁面。

處理 dApp 端不匹配

1. 檢查 dApp 的前端 JavaScript 控制台是否有「不支援的鏈 ID」警告－這些警告揭示了應用程式期望的確切鏈 ID。

2. 使用瀏覽器的開發者工具找到web3提供者初始化程式碼並驗證其是否使用正確的參數來呼叫ethereum.request({ method: 'wallet_addEthereumChain' }) 。

3. 如果 dApp 發起自動切換，請暫時停用 MetaMask 的「自動鎖定」設置，以防止鏈協商期間會話中斷。

4. 在重新連線之前清除 dApp 網域的網站 cookie 和本機儲存 - 快取的提供者狀態可能會保留先前的鏈上下文。

5.避免使用MetaMask的行動應用程式進行調試；桌面擴充透過設定 → 進階 → 顯示 RPC 呼叫提供完整的 RPC 檢查。

使用開發者工具進行調試

1. 啟動 Chrome DevTools 並前往「網路」選項卡，然後過濾「rpc」或「json-rpc」請求以觀察失敗的負載回應。

2. 在 Console 標籤中，執行ethereum.chainId來擷取目前偵測到的鏈 ID 並將其與預期值進行比較。

3. 手動執行await ethereum.request({ method: 'eth_chainId' })以確認MetaMask 傳回的ID 是否與其UI 中顯示的ID 相同。

4. 檢查應用程式 → 儲存 → IndexedDB 下的 IndexedDB 項目，看看「metamask」資料庫中是否有損壞的鏈元資料。

5. 監視「Provider Error」事件偵聽器輸出，以區分網路逾時、無效回應結構或不支援的方法錯誤。

常見問題解答

Q：為什麼我的 dApp 新增了正確的網路後仍顯示「不支援鏈」？答：dApp 可能會強制執行鏈 ID 以外的其他驗證，例如要求特定的 EIP-1559 支援標誌或強制執行與節點同步狀態不符的嚴格區塊時間戳視窗。

Q：我可以同時添加多個鏈而不需要手動切換嗎？答：是的。 MetaMask 持久性儲存所有自訂網路；使用者可以透過網路下拉清單立即在它們之間切換，而無需重新配置。

Q：禁用隱私模式是否會影響鏈檢測？答：是的。啟用隱私模式後，MetaMask 會限制 dApp 對鏈資訊的訪問，直到用戶明確批准為止，導致初始檢測失敗，直到獲得許可。

Q：如果兩個 dApp 請求同一鏈 ID 的不同版本，會發生什麼事？答：MetaMask 將它們視為相同，除非它們的 RPC 端點不同；衝突的區塊瀏覽器或貨幣符號可能會導致 UI 不一致，但不會破壞連線。