JAR无法识别引用库，运行java -jar时抛出java.lang.NoClassDefFoundError

兄弟，这个坑我太熟了！你遇到的java.lang.NoClassDefFoundError本质上是打包JAR时没把依赖的第三方库（这里就是icePDF相关的JAR包）正确纳入运行环境——IDE的构建路径只是让编译阶段能找到类，但用java -jar启动时，JVM根本找不到这些依赖文件。

为什么会这样？ #

IDE的构建路径是给编译器用的，它告诉IDE“编译时去哪里找这些类”，但当你导出普通JAR时，默认不会把依赖的库打包进去，也不会告诉JVM运行时去哪里找这些库。你看到的org/icepdf/core/exceptions/PDFException找不到，就是因为JVM在启动时的类路径里没有icePDF的JAR文件。

具体解决方案 #

我给你几个实用的解决办法，按省心程度排序：

1. 导出「可执行Fat JAR」（最推荐）

直接让IDE把所有依赖打包到你的JAR里，这样一个JAR就能独立运行：

• 如果用Eclipse：右键项目 → Export → 选择Runnable JAR File → 在"Libraries handling"里选Package required libraries into generated JAR → 导出后直接运行java -jar app.jar就行。
• 如果用IntelliJ：右键项目 → Open Module Settings → 选择Artifacts → 点击+新建JAR→From modules with dependencies → 配置好主类，勾选"Extract to the target JAR" → 构建后生成的JAR就是包含所有依赖的Fat JAR。

2. 手动配置MANIFEST.MF并放置依赖包

如果你不想打包成Fat JAR，可以手动告诉JVM依赖的位置：

• 把所有icePDF的依赖JAR（比如icepdf-core.jar、icepdf-viewer.jar等）和你的app.jar放在同一个目录下。
• 编辑JAR里的META-INF/MANIFEST.MF文件，添加一行：

  Class-Path: icepdf-core.jar icepdf-viewer.jar 其他依赖.jar
  

  注意：多个JAR之间用空格分隔，不要换行。
• 用命令更新JAR里的MANIFEST：jar umf MANIFEST.MF app.jar
• 现在运行java -jar app.jar就能找到依赖了。

3. 用构建工具自动处理（Maven/Gradle）

如果你的项目用Maven或Gradle，配置插件一键生成可执行JAR：

• Maven：在pom.xml里添加maven-shade-plugin插件，配置主类后执行mvn package，生成的JAR会包含所有依赖。
• Gradle：添加shadow插件，配置shadowJar任务指定主类，执行./gradlew shadowJar即可生成Fat JAR。

额外注意（JavaFX项目） #

因为你是在JavaFX Application Thread报错，还要确认：

• 如果是模块化项目，module-info.java里要声明对icePDF模块的依赖：requires org.icepdf.core;
• 如果用JavaFX 11+，启动时可能需要指定JavaFX的模块路径，但先解决依赖找不到的问题，这个是次要的。

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