Firebase部署Functions报错：期望清单YAML指定版本号

AI 小北

2026-8-17

Firebase部署Functions时“Expect manifest yaml to specify a version number”错误排查

错误原因

这个问题是由于Firebase Functions的构建清单文件（firebase-manifest.yaml）缺少必填的版本号字段导致的，常见于使用新版本Firebase CLI但项目配置文件未正确生成的场景。

修复firebase-manifest.yaml文件
在项目根目录找到该文件（若不存在可手动创建），确保文件开头声明版本号：
```
version: 1
```
基础的有效清单结构示例：
```
version: 1
projects:
  你的项目ID:
    resources:
      functions:
        codebase: default
```
更新Firebase CLI到最新版本
旧版本CLI可能存在配置文件生成的兼容性问题，执行命令更新：
```
npm install -g firebase-tools
```
重新初始化Functions模块
若上述方法无效，可重新初始化Functions模块（不会影响已有的Hosting、Firestore配置）：
```
firebase init functions
```
选择当前项目，按需确认语言等配置后，重新尝试部署。
检查firebase.json的Functions配置
确保firebase.json中Functions的配置路径正确、无语法错误，示例：
```
{
  "functions": {
    "source": "functions"
  }
}
```