如何修復 MetaMask 不顯示代幣餘額的問題？ （故障排除）

了解代幣餘額可見度問題

1. MetaMask 依賴外部區塊鏈節點來獲取代幣餘額，如果所選的網路 RPC 端點無回應或配置錯誤，則代幣餘額可能不會出現。

2. 自訂代幣合約必須在 Etherscan 或同等瀏覽器上進行驗證；儘管鏈上持有，但未經驗證的合約通常會導致餘額顯示為零或缺失。

3. 由於帳戶切換不正確，MetaMask 中使用的錢包地址可能與持有代幣的錢包地址不同——用戶有時會忽略右上角的活躍帳戶選擇。

4. 代幣標準很重要：ERC-20代幣在手動添加時需要正確的合約地址、符號和小數輸入，而ERC-721或ERC-1155資產不會在主資產列表中顯示為餘額，除非介面版本明確支援。

5. 瀏覽器擴充功能衝突（尤其是與廣告攔截器、隱私工具或其他 Web3 注入器的衝突）可以透過幹擾 MetaMask 的內容腳本執行來抑制平衡渲染。

驗證網路配置

1. 確認 MetaMask 連接到代幣所在的正確網絡，例如，基於 BSC 的 BEP-20 代幣不會顯示在以太坊主網上。

2. 檢查自訂 RPC URL 是否包含 Infura 或 Alchemy 等服務的有效 API 金鑰；過期或速率受限的金鑰會默默傳回空響應。

3. 網路之間的切換會觸發快取失效－在網路變更後強製手動刷新（Ctrl+R 或 Cmd+R）通常可以解決過時的平衡狀態。

4. 部分測試網歸檔節點支援不一致；使用 Chainstack 或 QuickNode 等公共端點可以提高 MetaMask 提供的預設 URL 的可靠性。

5. 如果使用 Geth 或 Hardhat 等本地節點，請確保節點公開 eth_getBalance 和 eth_call 端點，並且 CORS 標頭允許來自 localhost:3000 或類似來源的請求。

代幣添加和合約驗證

1. 手動添加代幣需要精確的合約地址匹配——區分大小寫很重要，儘管 MetaMask 會在貼上時自動標準化校驗和。

2. 透過代理模式（例如透明代理或 UUPS）部署的代幣可能會暴露實現地址而不是代理地址；查詢代理的實現槽會產生真實的合約位置。

3. 代幣的totalSupply必須非零且其轉帳功能可存取；轉帳暫停或所有者被列入黑名單的合約可能會報告餘額，但將其隱藏在 UI 層中。

4. 鏈上儲存和 MetaMask 輸入之間的小數精度不匹配導致顯示異常，例如，為鏈上只有 9 位的代幣輸入 18 位小數，結果餘額除以 10 億。

5. MetaMask 快取來自社區來源清單（如 Token Lists 項目）的代幣元資料；過時或缺少的條目迫使人們依賴手動合約交互，而手動合約交互缺乏自動平衡邏輯。

瀏覽器和擴充環境檢查

1. 暫時停用所有非 MetaMask 擴展，尤其是那些將腳本注入 dApp 頁面的擴展，例如 Phantom、Coinbase Wallet 或 Rainbow。

2. 透過導覽至「設定」>「進階」>「重設帳戶」來清除 MetaMask 的內部快取；這會強制重新取得餘額而不刪除助記詞或帳戶。

3. 確保瀏覽器允許第三方cookie和網站資料；阻止這些可以防止 MetaMask 儲存令牌餘額輪詢所需的會話金鑰。

4. 嘗試在僅啟用 MetaMask 的隱身視窗中存取同一個 dApp — 這可以消除來自已儲存的登入、快取的 JS 套件或服務工作人員的干擾。

5. 在行動裝置上，驗證 MetaMask Mobile 應用程式是否使用與瀏覽器擴充功能相同的網路和帳戶 - 跨裝置同步不會擴展到令牌可見性設定。

常見問題解答

Q：為什麼我的代幣顯示 0.000000，即使 Etherscan 確認我持有它？答：這通常表示十進制不匹配或合約地址輸入不正確 - 使用 Etherscan 合約頁面中經過驗證的詳細資訊重新添加代幣。

Q：MetaMask 能否在一個視圖中同時顯示多個鏈的代幣？答：不會。 MetaMask 僅顯示目前所選網路的餘額。使用者必須手動切換網路才能看到相應的令牌。

Q：重置我的 MetaMask 帳戶是否會刪除我的私鑰？答：不會。重設帳戶會清除快取的餘額和交易記錄，但會完整保留您的助記詞和錢包存取權。

Q：為什麼有些代幣會出現在「收藏品」下而不是「資產」下？答：收藏品代表 NFT (ERC-721/ERC-1155)，它們與可替代代幣餘額分開跟踪，並且在 MetaMask 介面中需要不同的檢測邏輯。