Mac环境下用npm安装mysql/mysql2遇E404错误求助

问题重现 #

执行以下安装命令时返回404错误：

sudo npm install mysql

错误信息：

npm error code E404
npm error 404 Not Found - GET https://registry.npmjs.org/mysql - Not found
npm error 404
npm error 404  'mysql@*' is not in this registry.
npm error 404
npm error 404 Note that you can also install from a
npm error 404 tarball, folder, http url, or git url.
npm error A complete log of this run can be found in: /Users/kylecross/.npm/_logs/2024-12-08T18_53_25_082Z-debug-0.log

安装mysql2时遇到同样问题。

解决方案 #

以下是按优先级推荐的解决步骤：

• 检查并重置npm镜像源
  首先查看当前npm使用的镜像源：

  npm config get registry
  

  如果返回的不是官方源https://registry.npmjs.org/，执行以下命令重置：

  npm config set registry https://registry.npmjs.org/
  

• 清除npm缓存
  缓存异常可能导致包查找失败，执行强制清理：

  npm cache clean --force
  

• 避免使用sudo安装项目依赖
  sudo会改变npm的权限上下文，容易引发配置或权限问题，直接用普通用户权限安装：

  npm install mysql
  # 或安装mysql2
  npm install mysql2
  

• 指定具体版本安装
  如果自动拉取最新版本失败，可手动指定稳定版本号安装：

  # 安装mysql指定版本
  npm install mysql@2.18.1
  # 安装mysql2指定版本
  npm install mysql2@3.11.3
  

• 检查网络连通性
  验证能否正常访问npm官方registry：

  curl https://registry.npmjs.org/mysql
  

  如果无法返回JSON内容，说明网络存在访问限制，需检查防火墙、代理设置或切换网络环境。

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