如何让Cloud Run等待Spring Boot启动再健康检查并解决部署报错问题？

问题场景 #

将Spring Boot应用打包为Jar，通过Docker部署到GCP Cloud Run，使用的部署命令：

gcloud beta run deploy $SERVICE_NAME --image $IMAGE_NAME --region europe-north1 --project $PROJECT_ID

遇到两个核心问题：

1. 应用启动失败时返回错误：

Cloud Run error: The user-provided container failed to start and listen on the port defined provided by the PORT=8080 environment variable.
修复错误后重新执行部署命令，仍返回上述错误，但实际Cloud Run中应用已正常运行，需手动检查且要两次部署才生效。

2. 需要配置Cloud Run，使其在Spring Boot完全启动前不拒绝健康检查。

问题1：部署命令返回旧错误但实际应用正常的解决办法 #

• 分阶段部署：先发布新版本再切换流量
  问题根源是Cloud Run的部署验证逻辑会优先检查新版本启动状态，若之前失败过，可能存在验证时机或缓存干扰。可拆分部署步骤：

  1. 先部署新版本但不分配流量：

     gcloud beta run deploy $SERVICE_NAME --image $IMAGE_NAME --region europe-north1 --project $PROJECT_ID --no-traffic
     

  2. 确认新版本状态正常后，将100%流量切换到新版本：

     gcloud run services update-traffic $SERVICE_NAME --region europe-north1 --project $PROJECT_ID --to-latest
     

  此方式避免部署命令在验证阶段被旧错误影响，确保新版本完全就绪后再对外提供服务。

• 使用异步部署跳过实时验证
  若不需要部署命令的实时反馈，添加--async参数让命令立即返回，后续通过服务描述命令确认状态：

  gcloud beta run deploy $SERVICE_NAME --image $IMAGE_NAME --region europe-north1 --project $PROJECT_ID --async
  

问题2：配置Cloud Run等待Spring Boot启动完成 #

Spring Boot启动需要加载依赖、初始化上下文，默认健康检查可能在应用就绪前触发，导致部署失败。需通过启动探针、就绪检查和超时配置解决：

1. 确保Dockerfile适配Cloud Run端口变量 #

Spring Boot需监听Cloud Run提供的PORT环境变量，修改Dockerfile：

FROM openjdk:17-jdk-slim
WORKDIR /app
COPY target/your-app.jar app.jar
# 让Spring Boot读取PORT变量指定的端口
ENTRYPOINT ["sh", "-c", "java -jar app.jar --server.port=${PORT}"]

2. 添加Actuator健康端点支持 #

在Spring Boot的application.properties中启用健康检查端点：

management.endpoints.web.exposure.include=health
management.endpoint.health.show-details=always
management.health.livenessstate.enabled=true
management.health.readinessstate.enabled=true

3. 部署时配置启动探针与就绪检查 #

通过部署命令添加探针参数，给Spring Boot足够的启动缓冲时间：

gcloud beta run deploy $SERVICE_NAME --image $IMAGE_NAME --region europe-north1 --project $PROJECT_ID \
  --timeout=300 \
  # 启动探针：等待120秒后开始检查，最多重试10次，确保应用完成初始化
  --startup-probe=http-get --startup-probe-path=/actuator/health/liveness --startup-probe-port=${PORT} \
  --startup-probe-initial-delay-seconds=120 --startup-probe-period-seconds=10 --startup-probe-failure-threshold=10 \
  # 就绪检查：确认应用已完全就绪可处理请求
  --readiness-probe=http-get --readiness-probe-path=/actuator/health/readiness --readiness-probe-port=${PORT} \
  --readiness-probe-initial-delay-seconds=30 --readiness-probe-period-seconds=5

4. 调整启动超时时间 #

默认启动超时30秒不足以支撑Spring Boot启动，通过--timeout设置最大允许的启动时长（最大300秒）：

gcloud beta run deploy $SERVICE_NAME --image $IMAGE_NAME --region europe-north1 --project $PROJECT_ID --timeout=300

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