无法部署Firebase Functions：prod项目报Failed to fetch Run service undefined错误

DevOps 小满

2026-8-8

解决Firebase Functions生产环境部署失败（Error: Failed to fetch Run service undefined）

针对你遇到的生产环境部署失败问题，按以下步骤排查修复：

升级过时的Firebase SDK及工具
报错明确提示firebase-functions版本3.15.7不符合>=3.20.0的要求，旧版本SDK可能无法适配生产环境的最新部署流程。执行以下命令升级：
```
# 进入functions目录
cd E:\FlutterProjects\pegasus\functions
# 升级firebase-functions到最新稳定版
npm install --save firebase-functions@latest
# 全局升级firebase-tools部署工具
npm install -g firebase-tools@latest
```
注意：升级后需根据官方版本变更说明调整代码，适配可能存在的破坏性变更。
确认生产环境项目别名配置正确
检查当前激活的Firebase项目是否为prod别名：
```
firebase use
```
若未指向prod，切换到对应别名：
```
firebase use prod
```
同时通过firebase projects:list确认别名关联的项目ID无误。
启用Cloud Run API
报错提到"Failed to fetch Run service"，Firebase Functions（尤其是第二世代函数）依赖Cloud Run服务。登录prod项目的Google Cloud控制台，搜索并启用Cloud Run API。
验证部署账号权限
确保用于部署的Google账号拥有prod项目的以下核心权限：
- Cloud Functions Admin
- Cloud Run Admin
- Cloud Build Editor
- Artifact Registry Administrator
  若使用服务账号部署，检查服务账号的角色配置是否完整。
清理缓存后重新部署
旧部署缓存可能引发异常，执行清理命令后重新尝试部署：
```
firebase deploy --only functions --clear-cache
```