window.ethereum.addListener不是函数问题排查求助

以下是导致window.ethereum.addListener is not a function报错的几种常见原因：

• 钱包注入时机与初始化顺序问题
  部分钱包扩展并非同步完成window.ethereum的注入与API挂载：可能先创建了一个空的window.ethereum对象，后续才异步加载并挂载addListener等核心方法。你的代码执行时刚好卡在这个中间阶段，就会触发报错。这种情况多发生在页面加载速度快、钱包初始化慢的场景下，因此会随机出现。

• 钱包API实现不兼容EIP-1193标准
  EIP-1193标准中，监听事件的标准方法是ethereum.on(eventName, callback)，而addListener并非强制要求实现的方法。一些早期版本的主流钱包（如旧版MetaMask）或小众钱包，可能只实现了标准的on方法，未提供addListener扩展，导致调用时出错。

• 多钱包冲突导致对象异常
  如果用户安装了多个以太坊钱包扩展，不同钱包注入的window.ethereum对象可能存在差异。当浏览器优先注入了某个不支持addListener的钱包对象，或者用户切换钱包时出现对象替换但新对象未携带该方法，就会触发报错。

• 钱包扩展自身的bug
  部分钱包在特定浏览器版本、系统环境下可能存在初始化bug，导致ethereum对象的方法丢失。这类问题通常是随机出现的，与钱包的内存管理、异步加载逻辑异常有关。

对应的解决建议： #

1. 改用标准的on方法绑定监听
   直接替换addListener为EIP-1193标准的on方法，兼容性更强：

   if (window.ethereum) {
     window.ethereum.on('accountsChanged', async () => {
       await doSomething();
     });
   }
   

2. 确保钱包完全初始化后再绑定事件
   通过轮询确保API方法存在后再执行绑定逻辑：

   function initEthereumListener() {
     if (window.ethereum && typeof window.ethereum.on === 'function') {
       window.ethereum.on('accountsChanged', async () => {
         await doSomething();
       });
     } else {
       setTimeout(initEthereumListener, 100);
     }
   }
   initEthereumListener();
   

   部分钱包支持ethereum#initialized事件，也可以用这个事件触发初始化：

   window.addEventListener('ethereum#initialized', () => {
     window.ethereum.on('accountsChanged', async () => {
       await doSomething();
     });
   });
   

内容的提问来源于stack exchange，提问作者strangeQuirks