同时安装Metamask与Coinbase扩展时如何获取Metamask的ethereum对象

数据老陈

2026-10-3

多钱包扩展共存时MetaMask ethereum对象获取方案

当浏览器同时安装MetaMask、Coinbase Wallet两款EVM钱包扩展时，二者都会向页面注入window.ethereum对象，后注入的实例会覆盖先注入的实例，导致默认window.ethereum可能不是MetaMask实例，无法正常执行为MetaMask适配的逻辑。可以通过以下方式精准获取MetaMask对应的实例：

从多实例数组中筛选

大部分多钱包共存场景下，所有注入的钱包实例会被汇总到window.ethereum.providers数组中，只需通过特征字段筛选即可：

筛选逻辑要同时匹配MetaMask独有标识、排除其他钱包的标识，避免部分钱包伪造isMetaMask字段做兼容导致误判
完整的获取代码如下：

function getMetaMaskProvider() {
  // 存在多钱包实例数组的场景，遍历筛选
  if (Array.isArray(window.ethereum?.providers)) {
    return window.ethereum.providers.find(
      provider => provider.isMetaMask === true && !provider.isCoinbaseWallet
    )
  }
  // 单实例场景直接判断特征
  if (window.ethereum?.isMetaMask === true && !window.ethereum?.isCoinbaseWallet) {
    return window.ethereum
  }
  // 未检测到MetaMask实例返回空
  return null
}

兼容扩展异步注入场景

如果页面脚本加载时机早于钱包扩展注入时机，可以通过监听ethereum#initialized事件确保能拿到实例：

function getMetaMaskProviderAsync() {
  return new Promise((resolve) => {
    const existingProvider = getMetaMaskProvider()
    if (existingProvider) {
      resolve(existingProvider)
      return
    }
    window.addEventListener('ethereum#initialized', () => {
      resolve(getMetaMaskProvider())
    }, { once: true })
  })
}