在Vercel中执行Firebase CLI命令报错：firebase: command not found

DevOps 小满

2026-6-26

解决Vercel环境中执行Firebase CLI命令提示"firebase: command not found"的问题

核心原因

Vercel的构建/运行环境默认不会全局安装Firebase CLI，且如果你的代码中覆盖了环境变量PATH但未包含项目依赖的node_modules/.bin路径，就会找不到本地安装的firebase命令。

可行解决方案

1. 将firebase-tools作为项目本地依赖安装

这是最可靠的方式，避免全局安装的不确定性：

执行本地安装命令：
```
npm install firebase-tools --save-dev
```

调整你的spawn代码，直接指定本地命令路径：

const firebaseDeploy = spawn(`./node_modules/.bin/firebase`, ['deploy', '--only', 'firestore'], {
    env: {
      ...process.env,
      // 添加上你的Firebase认证环境变量，比如FIREBASE_TOKEN
      FIREBASE_TOKEN: process.env.FIREBASE_TOKEN
    },
    cwd: process.cwd()
});

2. 通过npm scripts间接调用Firebase CLI

利用npm自动将node_modules/.bin加入PATH的特性，避免手动处理路径：

在package.json中添加脚本：

"scripts": {
  "deploy:firestore": "firebase deploy --only firestore"
}

代码中调用npm脚本：

const firebaseDeploy = spawn('npm', ['run', 'deploy:firestore'], {
    env: {
      ...process.env,
      FIREBASE_TOKEN: process.env.FIREBASE_TOKEN
    },
    cwd: process.cwd()
});

3. 确保环境变量PATH包含依赖路径

如果你坚持直接调用firebase命令，需要确保自定义的firebaseEnv中包含node_modules/.bin：

const firebaseEnv = {
  ...process.env,
  // 合并本地依赖路径到PATH
  PATH: `${process.cwd()}/node_modules/.bin:${process.env.PATH}`,
  // 你的Firebase环境变量
  FIREBASE_TOKEN: process.env.FIREBASE_TOKEN
};

const firebaseDeploy = spawn('firebase', ['deploy', '--only', 'firestore'], {
    env: firebaseEnv,
    shell: true,
    cwd: process.cwd()
});