安装任意npm包时触发MaxListenersExceededWarning问题求助

问题说明 #

安装任意npm包时触发以下警告：

(node:13133) MaxListenersExceededWarning: Possible EventEmitter memory leak detected. 11 close listeners added to [TLSSocket]. Use emitter.setMaxListeners() to increase limit

当前环境：

• npm版本：9.7.2
• Node.js版本：v20.4.0

解决方案 #

1. 临时提升监听器上限（单次生效） #

执行安装命令前，通过环境变量临时提高EventEmitter的监听器上限：

export NODE_MAX_LISTENERS=100 && npm install [你的包名]

Windows系统使用：

set NODE_MAX_LISTENERS=100 && npm install [你的包名]

2. 全局配置永久生效 #

如果每次安装都出现该警告，可将配置永久写入环境变量：

• Linux/macOS：在~/.bashrc或~/.zshrc中添加以下内容，执行source ~/.bashrc（对应你的配置文件）生效：

  export NODE_MAX_LISTENERS=100
  

• Windows：在系统环境变量中新增NODE_MAX_LISTENERS，值设为100，重启终端后生效。

3. 更新npm到最新版本 #

该警告可能是特定npm版本的已知问题，尝试升级npm：

npm install -g npm@latest

4. 清理npm缓存 #

缓存损坏可能导致异常的监听器创建，清理后重试安装：

npm cache clean --force

补充说明 #

这个警告是Node.js对EventEmitter监听器数量的默认限制（默认10个）被触发，多数情况下不会阻止安装完成，但如果确实导致安装失败，以上方法可解决问题。在npm工具场景下，适当提升监听器上限是安全的。

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