Firebase Functions部署报错：sendNotification函数部署异常

先把你提供的部署日志贴出来方便参考：

functions: 已完成预部署脚本运行。
i functions: 正在检查必要API是否启用...
✔ functions: 所有必要API已启用
i functions: 准备函数目录以上传...
i functions: 已打包函数（53.73 KB）用于上传
✔ functions: 函数文件夹上传成功
i functions: 更新sendNotification函数...
⚠ functions[sendNotification]: 部署...

我之前部署Firebase Functions时也碰到过类似卡在这一步的情况，给你几个实用的排查方向：

• 先本地验证函数可用性
  打包成功不代表代码逻辑没问题，先在本地用模拟器测试：

  firebase emulators:start --only functions
  

  触发sendNotification函数，看看有没有语法报错、依赖缺失或者逻辑异常。另外要确认package.json里的firebase-functions和firebase-admin版本，尽量和你本地Firebase CLI的版本保持兼容，版本不匹配是常见的部署坑。

• 清理缓存后重新部署
  Firebase CLI的缓存有时候会残留旧文件导致部署异常，试试这几步：

  1. 先删除已部署的函数（如果之前有部署过）：

     firebase functions:delete sendNotification --force
     

  2. 清理本地缓存：

     rm -rf node_modules/.cache
     

  3. 重新安装依赖：

     npm install
     

  4. 重新部署单个函数：

     firebase deploy --only functions:sendNotification
     

• 检查项目配额和权限
  去Firebase控制台的Cloud Functions页面，看看有没有达到配额上限（比如函数数量、内存配额），超限会导致部署失败。另外确认你用来部署的账号有没有Cloud Functions的编辑权限，权限不足也会卡在更新步骤。

• 获取详细日志定位问题
  执行部署命令时加上--debug参数，能看到更底层的日志输出，方便找到具体报错原因：

  firebase deploy --only functions:sendNotification --debug
  

  从日志里找类似error、failed的关键词，比如可能是依赖包无法安装、函数入口配置错误等。

• 排查网络环境
  如果是在国内环境部署，可能是网络访问Google服务不稳定导致上传中断，试试切换到稳定的网络环境，或者检查代理设置是否影响了CLI的请求。

内容的提问来源于stack exchange，提问作者Naseem Ahmad