部署Firebase Cloud Functions遇EBADPLATFORM错误及firebase-tools降级失败求助

一、解决EBADPLATFORM依赖不兼容错误 #

错误核心是@next/swc-darwin-arm64@13.3.0为Mac ARM平台专属依赖，而Cloud Functions构建环境为Linux x64，导致兼容性冲突。按以下步骤处理：

• 清理本地依赖缓存：

  rm -rf node_modules package-lock.json
  

• 安装适配Linux x64的依赖包：

  npm install --platform=linux --arch=x64
  

• 若仍有问题，将冲突依赖标记为可选依赖：
  在package.json中添加：

  "optionalDependencies": {
    "@next/swc-darwin-arm64": "13.3.0"
  }
  

  之后重新执行npm install，部署时npm会忽略该依赖的平台不兼容问题。
• 检查Git提交：确保package-lock.json未被提交，若已提交则删除后重新生成适配Linux的锁文件再提交。

二、解决firebase-tools降级失败问题 #

全局版本未更新通常是旧版本残留或路径优先级问题，按以下步骤操作：

• 彻底卸载全局firebase-tools：

  npm uninstall -g firebase-tools
  

• 清理npm缓存：

  npm cache clean --force
  

• 重新安装指定版本：

  npm install -g firebase-tools@11.0.0
  

• 验证版本：

  firebase --version
  

• 若仍显示旧版本，检查命令路径：
  • Linux/Mac执行which firebase，Windows执行where firebase，确认输出路径为刚安装的版本路径，若存在多个路径，调整环境变量优先级，或直接使用绝对路径执行命令。
• 临时替代方案：使用npx直接指定版本部署，无需修改全局版本：

  npx firebase-tools@11.0.0 deploy --only functions
  

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