gcloud run deploy报错Revision未就绪无法提供流量如何解决

执行命令 #

gcloud run deploy api --region=$REGION --image=$IMAGE

运行日志 #

Deploying container to Cloud Run service [api] in project [[MASKED]] region [[MASKED]]
Deploying...
Creating Revision...........interrupted
Deployment failed
ERROR: (gcloud.run.deploy) Revision [[MASKED]] is not ready and cannot serve traffic.

*Revision is not ready and cannot serve traffic.*是Cloud Run部署失败的通用提示，不会直接返回根因，按下面的顺序排查即可：

1. 先获取版本级别的明确错误提示 #

先执行命令拉取失败版本的状态详情，这里会直接返回具体失败原因，无需盲目试错：

gcloud run revisions describe <报错日志里提到的Revision名称> --region=$REGION --format="value(status.conditions)"

返回结果中type: Ready对应的message字段会写明具体问题，常见的包括镜像拉取失败、端口监听错误、探针探测失败、权限不足、实例启动超时等。

2. 高频问题对应修复方案 #

• 容器启动故障
  • 服务没有监听8080端口：Cloud Run默认要求容器监听8080端口接收流量，如果你的服务用了其他端口，部署时追加--port=你的服务实际监听端口参数即可；
  • 容器启动直接崩溃：本地先执行docker run -p 8080:8080 $IMAGE运行目标镜像，验证本地能不能正常启动、访问8080能不能返回响应，常见问题包括代码语法错误、依赖缺失、启动命令配置错误、环境变量漏配，本地修复后重新推镜像再部署；
  • 启动超时：如果镜像体积大、启动需要加载大量模型/资源，默认4分钟的启动超时不够，部署时追加--startup-timeout=600把超时调到最大10分钟，后续再优化镜像体积、把启动时的重资源加载改成按需加载即可。
• 镜像拉取故障
  • 权限不足：如果镜像存储在Artifact Registry/Container Registry，确认Cloud Run使用的服务账号（默认是<项目编号>-compute@developer.gserviceaccount.com）有镜像所在仓库的读取权限；
  • 镜像路径错误/损坏：核对$IMAGE的完整路径（包含仓库地址、镜像名、标签）是否正确，重新推送一次镜像后再部署。
• 配置不匹配故障
  • 资源配额不足：如果部署时给的内存、CPU太小，服务启动时会直接OOM被杀死，可以先临时调到1核CPU、1G内存尝试部署，成功后再根据实际用量下调配置；
  • 健康检查配置错误：如果自定义了启动/存活探针，确认探针路径在服务里真实存在，能返回200响应，排查阶段可以先删掉自定义探针，用默认的TCP探测，等服务正常启动后再重新配置。

3. 查运行日志定位偶发问题 #

如果上述步骤没定位到根因，执行命令拉取最近1小时的服务运行日志，里面会有容器进程输出的完整报错、崩溃堆栈：

gcloud logging read "resource.type=cloud_run_revision AND resource.labels.service_name=api AND resource.labels.location=$REGION" --limit=50 --freshness=1h

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