Google Cloud Build构建Spring Boot报失败但实际部署正常怎么解决

架构老林

2026-9-27

问题根因与解决方法

你当前尝试调整gcloud部署步骤识别成功状态的思路不正确，该报错并非状态识别偏差导致，而是部署流程的镜像缓存、版本复用逻辑存在真实异常，你观察到的应用可正常访问，是因为复用了旧版本号对应的残留运行实例，并非本次部署的镜像成功启动。

核心原因

你当前使用固定的$_GAE_VERSION作为部署版本号，重复使用同版本号时，App Engine会优先复用节点缓存的旧镜像，这也是你之前多次出现推送新代码却部署旧版本的根因。
你清理Container Registry缓存后，旧版本号对应的镜像层被删除，gcloud部署时校验镜像完整性失败触发报错，但旧的版本实例未被销毁，因此应用仍可正常访问。

具体调整方案

1. 优先解决版本复用问题（同时解决旧代码缓存和本次报错）

将部署版本号改为每次构建唯一的动态值，使用Cloud Build内置的提交短哈希变量$SHORT_SHA，调整部署步骤的版本参数即可：

- id: "Deploy to app engine using gcloud image"
  name: 'gcr.io/cloud-builders/gcloud'
  args: ['app', 'deploy', 'target/appengine-staging/app.yaml',
         '-q', '$_GAE_PROMOTE', '-v', '$SHORT_SHA']
  timeout: 1600s

该调整会让每次推送代码对应唯一的部署版本，完全避免版本复用导致的缓存问题，也不会出现清理缓存后镜像层缺失的报错。

2. 如需开启部署详细日志

在gcloud部署命令中添加--verbosity=debug参数，即可输出镜像拉取、健康检查全流程的详细日志，方便后续排查问题：

- id: "Deploy to app engine using gcloud image"
  name: 'gcr.io/cloud-builders/gcloud'
  args: ['app', 'deploy', 'target/appengine-staging/app.yaml',
         '-q', '$_GAE_PROMOTE', '-v', '$_GAE_VERSION', '--verbosity=debug']
  timeout: 1600s

3. 权限校验确认

检查App Engine默认服务账号（格式为<你的项目ID>@appspot.gserviceaccount.com）是否已被授予Storage Object Viewer角色，避免偶发的权限校验失败问题。

4. 若必须保留固定版本号部署逻辑

可在部署前添加旧镜像清理步骤，强制gcloud重新上传完整的新镜像：

- id: "Clean up old version image"
  name: 'gcr.io/cloud-builders/gcloud'
  args: ['container', 'images', 'delete', 'gcr.io/$PROJECT_ID/appengine/default.$_GAE_VERSION:latest', '--quiet']
  allowFailure: true

将该步骤放在构建步骤之后、部署步骤之前即可，`allowFailure: true`配置可避免首次部署无对应镜像时步骤报错。

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