如何解决Cloud Run启动Spring Boot时出现的超时问题

核心思路 #

通过配置启动探针检测Spring Boot应用的实际就绪状态，避免TCP端口刚通就接入流量。 #

具体操作步骤 #

• 第一步：为Spring Boot应用配置就绪检测端点
  推荐引入Spring Boot Actuator组件，开箱提供健康检测接口：
  1. 引入依赖（Maven示例）：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-actuator</artifactId>
  </dependency>
  

  2. 在application.yaml/application.properties中开启健康检测端点：

  management:
    endpoints:
      web:
        exposure:
          include: health
    endpoint:
      health:
        show-details: never
  

  配置完成后，应用完全启动成功时，访问/actuator/health会返回200状态码，启动过程中返回404/503状态码。
• 第二步：配置CloudRun启动探针
  启动探针会在容器启动后定期检测指定接口，只有检测通过后才会将流量转发到该实例，gcloud部署命令示例：

  gcloud run deploy 你的服务名 \
    --image 你的镜像地址 \
    --startup-probe=http-get=/actuator/health \
    --startup-probe-initial-delay=5 \
    --startup-probe-period=2 \
    --startup-probe-failure-threshold=30
  

  参数说明：
  • --startup-probe-initial-delay：容器启动后等待多久开始第一次检测，单位秒
  • --startup-probe-period：两次检测的间隔时间，单位秒
  • --startup-probe-failure-threshold：最多允许检测失败的次数，超过后实例会被重启
    你可以根据自身应用的启动时长调整参数，总允许启动时长为 initial-delay + period * failure-threshold，建议设置为应用最大启动时长的1.5倍，避免正常启动的实例被误杀

可选优化方案 #

• 如果不想引入Actuator，可以自定义一个检测接口，监听Spring的ApplicationReadyEvent事件，只有收到该事件后接口才返回200状态码，替代Actuator的health端点。
• 优化Spring Boot启动速度：使用分层Jar构建镜像、开启懒加载、使用GraalVM编译原生镜像等，减少启动等待时间。

内容的提问来源于stack exchange，提问作者三原拓也