GAE标准环境Java8迁移Java11：部署及本地服务启动失败求助

问题根源 #

你遇到的javax.servlet.UnavailableException: Servlet类xxx不是javax.servlet.Servlet错误，本质是Servlet API类加载冲突或依赖版本不匹配：

• GAE Java11标准运行时内置Servlet API 3.1，你项目中使用的3.0.1版本与runtime提供的版本存在类定义不一致；
• 若src/main/webapp/WEB-INF/lib目录下存在servlet-api.jar，打包后war包自带的Servlet API会与GAE runtime的API冲突，导致类加载时类型不匹配。

解决方案 #

1. 升级Servlet API依赖版本 #

修改POM中javax.servlet-api的版本为3.1.0，保持scope=provided（GAE runtime会提供该依赖，无需打包进war）：

<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>3.1.0</version>
    <scope>provided</scope>
</dependency>

2. 清理WEB-INF/lib目录下的Servlet API包 #

检查src/main/webapp/WEB-INF/lib目录，删除其中的servlet-api.jar或任何包含javax.servlet类的jar包，避免与GAE runtime的API冲突。

3. 升级App Engine Maven插件 #

将appengine-maven-plugin版本升级至最新稳定版（如2.8.0），确保插件与Java11、GAE Java11 runtime兼容：

<plugin>
    <groupId>com.google.cloud.tools</groupId>
    <artifactId>appengine-maven-plugin</artifactId>
    <version>2.8.0</version>
</plugin>

4. 验证Servlet类的实现 #

检查你的MyServlet和EmailServlet类，确保：

• 正确导入javax.servlet.http.HttpServlet；
• 类定义为public class MyServlet extends HttpServlet，无拼写错误或继承错误。

5. 重新构建并测试 #

执行以下命令重新构建并本地测试：

mvn clean package
mvn appengine:run

部署时使用：

mvn appengine:deploy -Dapp.deploy.projectId=my_app_id -Dapp.deploy.version=newj11 -Dapp.deploy.promote=True

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