Firebase部署报错：npm ERR! code EUSAGE 求助

核心问题梳理 #

部署失败源于三个关键问题：

• npm ci执行失败，因为package.json与package-lock.json不同步
• ajv版本不匹配（锁文件中是8.12.0，实际需要6.12.6）
• 存在缺失的依赖包

分步解决方法 #

1. 同步package.json与锁文件 #

• 本地项目根目录执行：

  npm install
  

  该命令会更新package-lock.json，使其完全匹配package.json里的依赖声明。
• 执行完成后确认package-lock.json有更新，再尝试重新部署。

2. 修复ajv版本冲突 #

• 方法一：直接安装指定版本
  执行命令强制安装所需的ajv版本：

  npm install ajv@6.12.6 --save
  

  这会同时更新package.json和package-lock.json。
• 方法二：用npm override强制统一版本（适用于npm 8及以上版本）
  在package.json中添加以下配置：

  "overrides": {
    "ajv": "6.12.6"
  }
  

  然后执行npm install，确保依赖树中所有ajv实例都使用指定版本。

3. 补全缺失的依赖包 #

• 根据部署错误日志里列出的缺失依赖，逐个安装：

  # 生产依赖用--save，开发依赖用--save-dev
  npm install <缺失的依赖包名> --save
  

• 安装完成后，再次执行npm install更新锁文件。

4. 部署前预验证 #

• 本地执行npm ci，模拟Firebase部署时的依赖安装流程，确认无报错：

  npm ci
  

• 检查Firebase函数的Node.js版本配置（确保是16），和本地开发环境保持一致。
• 强制清理部署缓存，重新部署函数：

  firebase deploy --only functions --force
  

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