Java项目打包成可执行JAR文件时出现ClassNotFoundException异常的解决方法

许多Java开发者在将项目打包成可执行JAR文件时，都会遇到ClassNotFoundException或NoClassDefFoundError异常。本文分析一个新手开发者遇到的实际问题：使用Gradle打包项目时，引入第三方JAR包后出现NoClassDefFoundError: javax/xml/transform/e异常。在IDEA中运行正常，但打包后运行则报错。该开发者使用JDK20，第三方JAR包结构如题图所示。错误提示找不到javax/xml/transform/e类，开发者怀疑是类路径问题，但实际路径与报错信息略有差异，Gradle配置文件也如题图所示。

问题的根源在于JDK版本不兼容。javax.xml.transform包在高版本JDK（例如JDK20）中的结构可能已更改、移除或替换。即使在JDK20环境下IDEA运行正常，打包后的JAR文件在运行时仍可能找不到必要的类。

解决方案：降低JDK版本

立即学习“Java免费学习笔记（深入）”；

解决方法是将JDK版本切换到JDK1.8或其他兼容版本。JDK1.8包含javax.xml.transform包，且结构与该第三方JAR包兼容。切换到JDK1.8后，打包后的JAR文件就能正确加载所需类，避免NoClassDefFoundError异常。 这证明问题并非类路径配置错误，而是JDK版本兼容性问题。