NPM安装报错EHOSTUNREACH问题求助及相关异常咨询

问题本质 #

报错connect EHOSTUNREACH 2606:4700::6810:1123:443是npm通过IPv6连接官方包registry失败导致的。结合你降级Node到v16后问题消失的情况，说明新版Node在Ubuntu环境下存在IPv6网络兼容性问题，终端加载慢大概率和网络请求阻塞或Node环境配置冗余有关。

修复步骤 #

• 强制npm使用IPv4连接
  执行命令让npm优先使用IPv4，规避IPv6连接失败的问题：

  # 切换到官方registry的IPv4地址
  npm config set registry http://registry.npmjs.org/
  # 或者切换到国内镜像，同时禁用IPv6
  npm config set registry https://registry.npmmirror.com/
  npm config set ipv6 false
  

• 用nvm管理Node版本
  用nvm可以灵活切换Node版本，避免手动降级的繁琐：

  1. 安装nvm（可从官方渠道获取最新安装方式）
  2. 重启终端后，安装并切换到Node v16：

     nvm install 16
     nvm use 16
     

  3. 设置v16为默认版本，避免每次终端启动都要切换：

     nvm alias default 16
     

• 解决终端加载缓慢问题

  • 检查终端启动脚本（如~/.bashrc、~/.zshrc），注释掉多余的npm/Node相关初始化命令，比如自动执行的包检查或镜像切换脚本，测试加载速度是否改善。
  • 清理npm缓存，避免缓存文件过多导致加载延迟：

    npm cache clean --force
    

验证修复 #

执行你之前的命令测试是否恢复正常：

# 创建Vite React项目
npm create vite@latest my-react-app -- --template react
# 给现有项目安装daisyui
npm install daisyui

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