使用外部Jar库的可执行Jar出现NoClassDefFoundError问题

看起来你踩了Java打包的一个常见坑——Java默认不支持从Jar内部加载嵌套的Jar文件，这就是为什么你已经把Utilities.jar放进了ChecksumChecker.jar，但运行时还是找不到类的原因。让我一步步帮你解决：

核心问题分析 #

你通过jar tf看到ChecksumChecker.jar里包含了lib/Utilities.jar，但Java的类加载器只会从当前Jar文件外部的路径加载依赖，不会去扫描Jar内部的其他Jar包。你的Manifest里Class-Path: lib/Utilities.jar是正确的，但它指向的是ChecksumChecker.jar所在目录下的lib文件夹里的Utilities.jar，而不是Jar内部的那个。

解决方案一：使用外部依赖目录（推荐，保持依赖分离） #

1. 调整文件结构：把你的可执行Jar和依赖Jar分开存放，最终结构应该是这样的：

   你的应用目录/
   ├─ ChecksumChecker.jar
   └─ lib/
      └─ Utilities.jar
   

2. 重新打包可执行Jar：确保打包时不要把lib/Utilities.jar包含进去，只打包你自己的代码、资源和Manifest文件。在IntelliJ里可以这么操作：
   • 打开File > Project Structure > Artifacts
   • 找到你之前创建的Artifact，修改输出配置：只添加你的模块编译后的class文件和资源，不要把Utilities.jar添加到Jar内部，而是设置它的输出路径为lib/Utilities.jar（在Artifact的"Output Layout"里调整）
   • 重新构建Artifact，生成的ChecksumChecker.jar就不会包含嵌套的Jar了
3. 验证运行：在应用目录下执行java -jar ChecksumChecker.jar，此时类加载器会从./lib/Utilities.jar找到需要的类，错误应该就消失了。

解决方案二：合并所有类到单个Jar（适合分发单个文件） #

如果你希望只分发一个Jar文件，可以把Utilities.jar里的类合并到你的可执行Jar中：

• 在IntelliJ的Artifact配置里，选择你的依赖Jar（Utilities.jar），右键选择"Extract to the target JAR"
• 重新构建Artifact，生成的Jar会包含所有依赖类，运行时不需要额外的lib目录
• 或者用构建工具（比如Maven Shade插件、Gradle Shadow插件）来自动合并，这样更适合持续构建场景

额外验证步骤 #

• 运行jar xf ChecksumChecker.jar META-INF/MANIFEST.MF，查看Manifest里的Class-Path是否正确指向外部的lib/Utilities.jar
• 确认lib/Utilities.jar里确实包含rethfam/ultis/fileUtils.class（可以用jar tf lib/Utilities.jar检查）

我之前也遇到过这个问题，一开始以为把依赖打包进去就万事大吉，后来才发现Java类加载器的这个限制，按照上面的方法调整后就正常了。

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