npm install报MaxListenersExceededWarning错误求助

问题说明 #

使用2017款Mac，此前执行npm install一直顺畅，今日执行时持续抛出以下警告：

MaxListenersExceededWarning: Possible EventEmitter memory leak detected. 11 close listeners added to [TLSSocket]. Use emitter.setMaxListeners() to increase limit
(Use `node --trace-warnings ...` to show where the warning was created)

当前环境版本：

• node: v20.9.0
• npm: 10.1.0

排查与解决步骤 #

• 定位警告来源：执行以下命令追踪警告触发的调用栈，明确是npm内部模块还是第三方依赖导致的问题

  node --trace-warnings npm install
  

• 临时提高监听器上限（应急方案）：不想立刻排查依赖时，可临时设置环境变量绕过警告

  NODE_MAX_LISTENERS=100 npm install
  

• 清理npm缓存：缓存损坏可能引发异常行为，执行清理后重新安装

  npm cache clean --force
  npm install
  

• 调整npm版本：npm 10.x与Node 20.x的组合可能存在兼容性问题，尝试降级或升级npm

  # 降级到npm 9稳定版
  npm install -g npm@9.8.1
  # 或升级到最新稳定版
  npm install -g npm@latest
  

• 排查项目依赖：如果是第三方依赖触发的问题，查看package.json，尝试更新或临时移除可疑依赖后重新安装排查

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