Java运行Jar报NoClassDefFoundError：Classpath配置后仍无法识别Spark库

问题根源 #

你遇到的核心问题是Java的Manifest文件中Class-Path属性不支持通配符（*）。虽然你在配置里写了lib/*，但JVM解析Jar的Manifest时并不会自动扩展这个通配符去加载lib下的所有Jar包，它只会把lib/*当作一个字面量路径，自然找不到对应的spark类。

解决方案 #

方案1：修正Manifest的Class-Path为具体依赖Jar

把Manifest里的Class-Path替换成lib目录下所有依赖Jar的具体文件名，比如：

Manifest-Version: 1.0
Class-Path: lib/spark-core.jar lib/spark-web.jar（根据你实际的Spark依赖Jar名调整）
Main-Class: com.xx.xx.xx.Main

注意：

• 多个Jar之间用空格分隔
• 运行java -jar test.jar时，确保lib文件夹和test.jar在同一目录下

方案2：打包成胖Jar（Uber Jar）

这是更省心的方案，直接把所有依赖包和你的代码打包成一个单独的可执行Jar，彻底避免Class-Path路径和通配符的问题：

• 如果用Maven，可使用maven-shade-plugin插件，配置后执行mvn package就能生成包含所有依赖的Jar
• 如果用Gradle，可使用shadowJar插件，执行gradle shadowJar生成胖Jar

生成胖Jar后，直接运行java -jar your-fat-jar.jar即可，不需要额外的lib文件夹。

方案3：手动指定ClassPath运行

如果不想修改Manifest或打包胖Jar，也可以在运行时手动指定完整的ClassPath：

java -cp "test.jar:lib/*" com.xx.xx.xx.Main

（Windows系统把冒号换成分号：java -cp "test.jar;lib/*" com.xx.xx.xx.Main）

额外检查点 #

• 确认lib文件夹里的Spark依赖Jar确实包含spark.Spark类，可以用jar tf lib/spark-core.jar | grep spark/Spark命令验证
• 确保运行Jar时的工作目录正确，lib文件夹是相对于当前工作目录的，而非Jar文件所在的目录（如果Jar不在当前目录，需要调整路径）

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