如何将本地开发的Spring应用部署至Google App Engine？

刚巧我前段时间把自己的Spring Boot应用部署到GAE了，踩了几个小坑，给你整理一套完整的步骤，照着来基本没问题：

一、前期准备工作 #

• 先安装好Google Cloud SDK，然后运行gcloud init完成初始化：登录你的Google账号，选择要部署的Cloud项目（没有的话先在Cloud控制台创建一个）
• 确保你的Spring应用在本地能正常启动，没有依赖缺失或端口冲突的问题
• 如果是传统Spring MVC项目（非Spring Boot），配置会复杂一点，下面主要讲Spring Boot的部署流程（目前大部分Spring应用都是Boot架构）

二、调整应用配置 #

1. 端口适配GAE要求 #

GAE会自动为应用分配端口，但它默认监听的是8080，所以要把Spring Boot的端口改成这个值。在application.properties里加：

server.port=8080

如果用的是application.yml，就写：

server:
  port: 8080

2. 添加GAE构建插件 #

Maven项目（pom.xml）

在<build>标签下的<plugins>里加入GAE插件：

<plugin>
    <groupId>com.google.cloud.tools</groupId>
    <artifactId>appengine-maven-plugin</artifactId>
    <version>2.4.4</version> <!-- 建议用官方最新稳定版 -->
    <configuration>
        <projectId>你的Google Cloud项目ID</projectId>
        <version>1</version> <!-- 版本号可以自定义，每次部署可以递增区分 -->
    </configuration>
</plugin>

Gradle项目（build.gradle）

在插件块里添加GAE插件：

plugins {
    id 'com.google.cloud.tools.appengine' version '2.4.4'
}

appengine {
    deploy {
        projectId = '你的Google Cloud项目ID'
        version = '1'
    }
}

3. 创建GAE核心配置文件 #

在项目的src/main/appengine目录下新建app.yaml（没有这个目录就手动创建），内容根据你的需求调整：

runtime: java17 # 对应你本地使用的JDK版本，支持java11、java17等，以Cloud控制台支持的版本为准
instance_class: F1 # F1属于免费额度内的实例类型，适合测试阶段
automatic_scaling:
  target_cpu_utilization: 0.65
  min_instances: 1
  max_instances: 2 # 免费额度内最多允许2个实例，超出会产生费用

三、本地模拟测试（可选但推荐） #

用GAE的本地模拟器跑一遍应用，确认配置没问题：

• Maven：执行mvn appengine:run
• Gradle：执行./gradlew appengineRun
  启动后访问http://localhost:8080，确保应用和本地运行时一样正常。

四、正式部署到GAE #

1. 先构建应用包 #

• Maven：mvn clean package，构建完成后会在target目录生成可执行jar包
• Gradle：./gradlew clean build，jar包会在build/libs目录下

2. 执行部署命令 #

• Maven：mvn appengine:deploy
• Gradle：./gradlew appengineDeploy
  执行后SDK会自动上传应用到GAE，耐心等部署完成（第一次可能慢一点），控制台会输出应用的访问地址，格式大概是https://你的项目ID.uc.r.appspot.com

五、常见问题排查 #

• 部署失败的话，用gcloud app logs tail -s default命令实时查看日志，大部分问题能从日志里找到原因
• 确认app.yaml里的runtime和本地JDK版本完全一致，比如本地用Java11就不能写java17
• 免费额度内不要把max_instances设得太高，超出2个会开始收费，测试阶段用F1实例足够
• 如果遇到权限问题，检查gcloud init时登录的账号有没有对应项目的部署权限

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