App Engine Java 11 Gradle项目部署后无法加载主类求助

将Java 8 App Engine项目迁移至Java 11环境，使用Gradle构建（官方文档多基于Maven），已完成大部分适配，但遇到以下问题：

• 本地通过VS Code运行工具可正常启动，执行命令包含主类com.example.server.ServerMain及所有依赖的argfile，端点均正常。
• 部署至App Engine后，无法加载嵌入式Jetty Server的主类。
• 尝试在build.gradle中配置war包的Manifest信息，生成了正确的MANIFEST.MF，但war包仍无法执行。
• 手动生成shadowJar后本地无法访问服务，且无法使用官方appengine-simple-jetty-main库（需自定义资源配置）。

需要一套同时支持本地运行及通过appengineDeploy任务部署的Gradle打包方案。

1. 引入并配置Gradle插件 #

在build.gradle中添加application和shadow插件，分别用于本地运行和构建可执行胖JAR，同时调整App Engine部署配置：

plugins {
    id 'java'
    id 'war'
    id 'com.google.cloud.tools.appengine' version '2.4.4'
    id 'application'
    id 'com.github.johnrengelman.shadow' version '8.1.1'
}

// 指定应用主类
application {
    mainClass.set('com.example.server.ServerMain')
}

// 配置shadowJar，打包所有依赖及自定义资源
shadowJar {
    // 包含src/main/resources下的所有配置资源
    from sourceSets.main.resources
    // 配置可执行JAR的主类
    manifest {
        attributes 'Main-Class': 'com.example.server.ServerMain'
    }
    // 若需将特定目录资源打包到指定路径，比如src/main/appengine到WEB-INF
    into('WEB-INF') {
        from 'src/main/appengine'
    }
    // 可选：固定生成的JAR文件名，方便app.yaml引用
    archiveName = 'your-app-name-all.jar'
}

// 关联appengineDeploy与shadowJar任务，部署胖JAR而非war包
appengine {
    deploy {
        artifact = shadowJar.archiveFile.get().asFile
        appYaml = file('src/main/appengine/app.yaml')
    }
}

// 本地运行任务配置，自动加载完整类路径
run {
    classpath sourceSets.main.runtimeClasspath
    // 可选：添加JVM参数，比如调整内存
    // jvmArgs = ['-Xmx512m']
}

2. 配置app.yaml指定入口点 #

在src/main/appengine/app.yaml中明确启动命令，确保App Engine正确加载主类：

runtime: java11
instance_class: F1
entrypoint: java -jar your-app-name-all.jar

3. 验证流程 #

• 本地运行：执行./gradlew run，直接启动嵌入式Jetty服务，效果与VS Code运行一致。
• 部署：执行./gradlew appengineDeploy，Gradle会先构建胖JAR，再自动部署到App Engine，按照app.yaml的入口点启动应用。

关键注意点 #

• 放弃war包部署：Java 11 App Engine标准环境更适配可执行JAR，避免war包类路径解析问题。
• shadowJar确保所有依赖打包到单个JAR，解决部署时的依赖缺失问题。
• application插件简化本地运行配置，无需手动维护复杂类路径。

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