将Eclipse中Google App Engine Java项目迁移至Gradle部署

一、关于移除Gretty/Jetty的确认 #

你移除Gretty和Jetty的操作完全正确。这两个库仅用于本地开发时启动嵌入式Servlet容器，部署到Google App Engine时，平台会提供自带的运行环境（基于Jetty），不需要依赖本地容器库。你遇到的baseName错误是旧版Gretty插件与高版本Gradle不兼容导致的，移除后不会影响部署功能。

二、核心问题：错误的部署模式导致服务不可用 #

你的原项目是传统Servlet项目（依赖web.xml映射），属于WAR包部署模式，但当前app.yaml配置成了JAR包独立应用模式（指定entrypoint和主类），两者不匹配：

• JAR包模式需要主类自行启动Servlet容器（如Spring Boot），但你的项目没有这类逻辑，仅运行Driver的main方法后进程就终止，导致服务不可用。
• WAR包模式下，GAE会自动用内置容器加载WAR包，无需自定义主类和entrypoint。

三、正确配置步骤 #

1. 修正build.gradle配置 #

确保构建出符合GAE要求的WAR包，建议明确依赖版本并使用稳定插件：

buildscript {
    repositories {
        mavenCentral()
    }
    dependencies {
        classpath 'com.google.cloud.tools:appengine-gradle-plugin:2.5.0'
    }
}

repositories {
    mavenCentral()
}

apply plugin: 'java'
apply plugin: 'war'
apply plugin: 'com.google.cloud.tools.appengine'

dependencies {
    providedCompile 'javax.servlet:javax.servlet-api:3.1.0'
    // 明确指定GAE SDK版本，避免版本不确定性
    providedCompile 'com.google.appengine:appengine:1.9.99'
    // 添加项目原有业务依赖
}

appengine {
    deploy {
        stopPreviousVersion = true
        promote = true
        war = file("${buildDir}/libs/${project.name}.war")
    }
}

sourceCompatibility = 11
targetCompatibility = 11

2. 修正app.yaml配置 #

使用WAR包模式配置，无需entrypoint：

runtime: java11
service: serviceName
# 若项目已有web.xml，可省略handlers，GAE会自动处理Servlet映射
handlers:
  - url: /.*
    script: auto

3. 调整项目结构适配Gradle #

将原Eclipse项目结构对齐Gradle WAR插件默认规范：

• src/main/java：存放所有Java代码（包括原有的Servlet类）
• src/main/webapp：迁移原Eclipse中WebContent目录的内容（web.xml、静态资源、WEB-INF等）

4. 执行部署 #

在项目根目录运行Gradle部署命令，插件会自动构建WAR包并完成部署：

./gradlew appengineDeploy

也可先单独构建WAR包，再用gcloud命令部署：

./gradlew war
gcloud app deploy build/libs/your-project-name.war

四、问题排查 #

若部署后仍有异常，可通过以下命令查看服务日志定位问题：

gcloud app logs tail -s serviceName

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