Node.js中执行npm install --save firebase-admin安装firebase-admin失败的解决方法

我之前在部署Node.js项目时也碰到过安装firebase-admin失败的情况，下面是几个实用的排查和解决步骤，你可以按顺序尝试：

1. 确认环境版本符合要求 #

firebase-admin对Node.js的版本有明确要求（目前官方推荐使用Node.js 16.x、18.x或20.x LTS版本），先检查你的版本是否达标：

• 执行 node -v 查看Node.js版本
• 执行 npm -v 查看npm版本
  如果版本过低，建议升级到对应LTS版本（可以用nvm来管理多版本Node.js，避免全局安装权限问题）

2. 清理npm缓存 #

缓存损坏是npm安装失败的常见原因，先强制清理缓存再重试：

npm cache clean --force
npm install --save firebase-admin

3. 解决网络访问问题 #

如果你的网络环境访问npm官方源不稳定，切换到国内镜像源试试：

npm config set registry https://registry.npmmirror.com/
npm install --save firebase-admin

如果之前设置过代理，也可能导致问题，可删除代理配置：

npm config delete proxy
npm config delete https-proxy

4. 处理权限问题 #

• Linux/macOS用户：避免用sudo执行npm安装，这会导致后续权限混乱。如果必须用，可以添加--unsafe-perm参数临时解决：

  npm install --save firebase-admin --unsafe-perm
  

  更推荐的方式是用nvm管理Node.js，让当前用户拥有npm包的安装权限。
• Windows用户：右键终端/命令提示符，选择「以管理员身份运行」后再执行安装命令。

5. 修复依赖冲突或损坏 #

如果项目中存在依赖冲突或者已安装的包损坏，先删除旧的依赖文件再重新安装：

• Linux/macOS：

  rm -rf node_modules package-lock.json
  npm install --save firebase-admin
  

• Windows：

  rmdir /s node_modules
  del package-lock.json
  npm install --save firebase-admin
  

  如果还是不行，可以尝试安装特定的稳定版本（比如已知兼容的11.11.0版本）：

  npm install --save firebase-admin@11.11.0
  

6. 排查系统安全限制 #

有时候防火墙、杀毒软件会拦截npm的下载请求，临时关闭这类软件后再尝试安装，确认是否是这个原因导致的失败。

内容的提问来源于stack exchange，提问作者مروان بن أحمد