如何修复 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 应用程序是否使用与浏览器扩展相同的网络和帐户 - 跨设备同步不会扩展到令牌可见性设置。

常见问题解答

问：为什么我的代币显示 0.000000，即使 Etherscan 确认我持有它？答：这通常表示十进制不匹配或合约地址输入不正确 - 使用 Etherscan 合约页面中经过验证的详细信息重新添加代币。

问：MetaMask 能否在一个视图中同时显示多个链的代币？答：不会。MetaMask 仅显示当前所选网络的余额。用户必须手动切换网络才能看到相应的令牌。

问：重置我的 MetaMask 帐户是否会删除我的私钥？答：不会。重置帐户会清除缓存的余额和交易历史记录，但会完整保留您的助记词和钱包访问权限。

问：为什么有些代币出现在“收藏品”下而不是“资产”下？答：收藏品代表 NFT (ERC-721/ERC-1155)，它们与可替代代币余额分开跟踪，并且在 MetaMask 界面中需要不同的检测逻辑。