升级Java 11至Google App Engine后无法找到主类问题

核心原因分析 #

部署时出现ClassNotFoundException，核心是App Engine环境下的类路径配置未正确指向war包内的类文件。本地运行正常是因为本地环境自动关联了编译后的classes目录和依赖jar，但部署到App Engine后，war包作为归档文件，JVM默认不会从其内部加载类。

具体解决方案 #

1. 修正entrypoint的类路径配置 #

将app.yaml中的entrypoint调整为正确指向war包内的类和依赖：

runtime: java11
env: standard
entrypoint: java -cp "myprojectName-1.0.war:WEB-INF/lib/*:WEB-INF/classes" mypackageName.ServerMain

• 说明：myprojectName-1.0.war指定war包路径，WEB-INF/lib/*包含所有依赖jar，WEB-INF/classes包含编译后的主类文件，三者组合才能让JVM找到ServerMain类。

2. 验证war包内的主类位置 #

检查打包后的myprojectName-1.0.war，确认ServerMain.class存在于WEB-INF/classes/mypackageName/路径下：

• 可通过命令 jar tf myprojectName-1.0.war 查看war包内容，确保路径匹配。

3. 检查Maven打包配置 #

确保maven-war-plugin正确将编译后的类文件打包到war的WEB-INF/classes目录，在pom.xml中添加或确认以下配置：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-war-plugin</artifactId>
      <version>3.3.2</version>
      <configuration>
        <failOnMissingWebXml>false</failOnMissingWebXml>
        <webResources>
          <resource>
            <directory>target/classes</directory>
            <targetPath>WEB-INF/classes</targetPath>
          </resource>
        </webResources>
      </configuration>
    </plugin>
  </plugins>
</build>

4. 简化entrypoint（可选） #

如果ServerMain是嵌入式Web服务器（如Jetty、Tomcat）的启动类，可将项目打包为可执行jar，此时entrypoint可简化为：

entrypoint: java -jar myprojectName-1.0.jar

需在pom.xml中配置maven-shade-plugin或maven-assembly-plugin构建可执行jar，并正确指定主类。

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