iText7非Maven导入Eclipse后运行报找不到PdfDocument的NoClassDefFoundError

你遇到的NoClassDefFoundError: com/itextpdf/kernel/pdf/PdfDocument本质是运行时类路径没有正确包含iText的预编译二进制依赖，之前直接导入源码触发的连锁编译错误也是因为操作路径完全不对，按以下步骤操作即可解决：

1. 区分源码目录与预编译JAR，杜绝错误的源码导入操作 #

iText 7 采用模块化拆分设计，你下载的累积发布包内的预编译二进制文件全部存放在解压目录的lib子文件夹下，绝对不要把仓库里的源码目录直接拷贝到项目src路径下：

• 仅单独导入PdfDocument类的源码时，会因为缺少跨模块的依赖引用触发大量连锁编译错误，完全没必要走源码引入的路线
• 实现PDF文本解析功能的必需核心JAR包括：
  • kernel-7.1.14.jar：包含代码中引用的PdfDocument、PdfReader类
  • io-7.1.14.jar：kernel模块的强制底层依赖
  • commons-7.1.14.jar：kernel模块的通用工具依赖

2. 在Eclipse中正确配置构建路径 #

• 右键目标项目，依次选择 Build Path → Configure Build Path
• 切换到Libraries标签页，点击Add External JARs，定位到上述3个JAR文件，逐个选中并确认添加
• 配置完成后，展开项目下的Referenced Libraries节点，验证是否能从kernel-7.1.14.jar中直接定位到com.itextpdf.kernel.pdf.PdfDocument类——能正常跳转查看类结构就说明类路径编译期配置生效

3. 补充两处代码逻辑修正，避免类路径配置完成后触发新异常 #

• iText 7的PDF页码从1开始计数，原代码中p.getPage(0)会直接抛出索引越界异常，提取第一页内容需修改为p.getPage(1)
• 打开的PDF文档需在解析完成后手动调用p.close()释放文件句柄，避免系统占用文件导致的读写异常

4. 验证运行时类路径配置 #

因为代码运行在AWT事件调度线程中，Eclipse的GUI程序运行配置有时会和项目全局构建路径脱节：

• 右键程序主类，选择 Run As → Run Configurations
• 切换到Classpath标签页，确认上述3个iText JAR已经列在User Entries分组下
• 如果列表缺失对应JAR，手动通过Add External JARs补入后再启动程序即可

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