Google Cloud Run无法运行Paketo Buildpacks构建的Spring Boot镜像求助

核心问题分析 #

Cloud Run要求容器必须监听PORT环境变量指定的端口（默认8080），你的Spring Boot应用当前可能未正确读取该变量调整监听端口；另外Docker镜像的EXPOSE仅为元数据，不影响应用实际监听逻辑，Cloud Run也不依赖该指令。

具体解决步骤 #

1. 配置Spring Boot动态监听PORT变量 #

在Spring Boot配置文件中添加端口配置，让应用优先读取环境变量PORT，默认 fallback到8080：

• 若使用application.properties：

server.port=${PORT:8080}

• 若使用application.yml：

server:
  port: ${PORT:8080}

2. 本地验证镜像功能 #

构建镜像后，本地启动测试是否能正确读取PORT变量：

docker run -e PORT=8080 -p 8080:8080 docker.io/library/bff:1.0-SNAPSHOT

执行curl localhost:8080访问，确认应用能正常响应。

3. 检查Cloud Run启动日志 #

部署失败后，在Cloud Run控制台查看对应Revision的日志，重点查找类似以下的启动日志：

Tomcat started on port(s): 8080 (http) with context path ''

确认应用实际监听的端口是否与Cloud Run设置的PORT一致。若日志显示监听端口不符，需检查Spring Boot配置是否生效。

4. 确认Paketo Buildpack启动配置 #

从你的构建日志可见，Paketo已正确识别Web应用，默认启动命令为java org.springframework.boot.loader.launch.JarLauncher，该命令会自动加载Spring Boot配置，只要配置文件正确读取PORT变量即可正常运行。

额外说明 #

• Docker的EXPOSE指令仅声明容器可能使用的端口，不实际暴露端口，本地必须通过-p映射才能访问，属于正常行为；Cloud Run无需依赖该指令，只要应用监听指定端口即可。
• Cloud Run会自动设置PORT环境变量，默认值为8080，你也可在Cloud Run服务配置中自定义该值，但需确保应用配置同步读取。

内容的提问来源于stack exchange，提问作者K.Nicholas