Tomcat 8.5.69部署应用抛出org.apache.catalina.LifecycleException如何解决

问题根因 #

java.lang.UnsupportedClassVersionError: Unsupported major.minor version 52.0是典型的JDK版本不兼容报错：版本号52.0对应JDK 8编译生成的类文件，而你的开发服务器上运行的JVM版本为1.7，无法识别更高版本编译的类，所以导致应用启动失败。
你本地Ubuntu 20+Tomcat 9环境默认搭配JDK 8及以上版本，因此应用可以正常运行。

排查步骤 #

• 确认Tomcat实际绑定的JDK版本，避免环境变量配置偏差：进入Tomcat的bin目录，执行./version.sh，输出结果会明确显示当前使用的JVM版本，确认是否为1.7.x。
• 定位报错类的来源：报错指向org/apache/xerces/impl/xs/XMLSchemaValidator，确认该类所属的xerces依赖包版本，可执行javap -verbose 类全路径命令查看类的major版本号，确认是否为52.0。
• 核对应用打包的JDK版本：确认本地打包应用时是否使用了JDK 8及以上版本，且未指定编译兼容JDK 1.7的参数。

解决方法 #

方案1：升级服务器JDK版本（最推荐） #

Tomcat 8.5.x本身支持JDK 7及以上版本，直接将服务器上的JDK升级到1.8.x版本，重启Tomcat后重新部署应用即可，无需修改应用代码和配置。

方案2：调整应用编译配置适配JDK 1.7 #

如果暂时无法升级服务器JDK，可修改应用编译参数，指定兼容JDK 1.7：

• Maven项目在pom.xml中添加配置：

<properties>
  <maven.compiler.source>1.7</maven.compiler.source>
  <maven.compiler.target>1.7</maven.compiler.target>
</properties>

• Gradle项目在build.gradle中添加配置：

compileJava {
  sourceCompatibility = '1.7'
  targetCompatibility = '1.7'
}

• 同时排查所有依赖包，将JDK 8编译的依赖替换为兼容JDK 1.7的低版本，比如将xerces包降级到支持JDK 1.7的版本。

方案3：单独为Tomcat指定高版本JDK #

如果服务器上已经安装了JDK 8，不需要修改全局JDK配置，只需编辑Tomcat bin目录下的setenv.sh文件（无该文件可新建），添加export JAVA_HOME=/path/to/jdk8，保存后重启Tomcat即可。

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