Firebase云函数部署失败致旧版本失效，如何确保旧版本持续运行？

核心问题原因 #

你遇到的情况是因为2代Cloud Functions基于Cloud Run运行，默认部署流程会尝试将流量切换到新版本，即便新版本未就绪。一旦新版本创建失败但服务配置被更新，就会出现无可用版本提供流量的情况，而非保留旧版本。

具体解决方法 #

1. 采用"先部署后切流"的部署策略 #

针对单个函数部署时，避免直接将流量切换到未验证的新版本：

• 使用gcloud命令部署函数时，添加--no-traffic参数，先完成新版本部署但不分配流量：

  gcloud run deploy sendPushNotificationHttps --region us-central1 --image gcr.io/[你的项目ID]/sendPushNotificationHttps --no-traffic
  

• 验证新版本就绪后，再手动切换流量到最新版本：

  gcloud run services update-traffic sendPushNotificationHttps --region us-central1 --to-latest
  

如果使用Firebase CLI部署，可以结合脚本实现自动化检查，确保新版本就绪后再切流。

2. 配置Cloud Run健康检查 #

为函数添加就绪检查端点，确保只有健康的版本才会接收流量：

• 在HTTP函数中添加健康检查路径，例如：

  exports.sendPushNotificationHttps = functions.https.onRequest((req, res) => {
    if (req.path === '/health') {
      return res.status(200).send('OK');
    }
    // 原有函数逻辑...
  });
  

• 在Google Cloud控制台找到对应Cloud Run服务，配置就绪检查，路径设为/health，检查间隔设为10秒，失败阈值设为3次。这样新版本只有通过健康检查，才会被分配流量。

3. 部署后自动验证与回滚 #

编写简单脚本，在部署完成后自动检查函数状态，异常时触发回滚：

#!/bin/bash
PROJECT_ID="你的项目ID"
FUNCTION_NAME="sendPushNotificationHttps"
REGION="us-central1"

# 部署函数
firebase deploy --only functions:$FUNCTION_NAME

# 检查部署是否成功
if [ $? -ne 0 ]; then
  echo "[$FUNCTION_NAME] 部署失败，旧版本仍在运行，已触发告警"
  # 添加通知逻辑（如发送Slack/邮件）
  exit 1
fi

# 检查Cloud Run服务是否就绪
READY_STATUS=$(gcloud run services describe $FUNCTION_NAME --region $REGION --format="value(status.conditions[?type=='Ready'].status)")

if [ "$READY_STATUS" != "True" ]; then
  echo "[$FUNCTION_NAME] 新版本未就绪，回滚到旧版本"
  # 获取最新的健康旧版本ID
  OLD_REVISION=$(gcloud run revisions list --service $FUNCTION_NAME --region $REGION --filter="status.conditions.type=Ready AND status.conditions.status=True" --sort-by="~createTime" --format="value(name)" | head -n 1)
  gcloud run services update-traffic $FUNCTION_NAME --region $REGION --revision=$OLD_REVISION:100
  echo "已回滚到版本: $OLD_REVISION"
fi

4. 拆分部署批次 #

将100个函数按功能模块分组，单次只部署一组函数（如firebase deploy --only functions:notificationFunctions）：

• 减少单次部署的耗时和风险，单个分组部署失败不会影响其他模块
• 更容易定位和处理部署异常

5. 配置实时告警 #

在Google Cloud操作套件中创建告警规则：

• 监控指标选择Cloud Run > Service > Revision ready status
• 设置告警条件为"状态变为非就绪"
• 配置通知渠道（邮件、短信、企业IM），确保部署异常时第一时间收到通知，无需等待用户反馈

内容的提问来源于stack exchange，提问作者Varun Gupta