Java项目添加PDFbox-3.0.0.jar至classpath后仍无法导入，求助排查

一、排查库结构问题 #

• 确认依赖完整性：PDFbox 3.x 不是单jar就能运行的，必须搭配核心依赖包。基础依赖至少包含：pdfbox-3.0.0.jar、fontbox-3.0.0.jar、commons-logging-1.2.jar、commons-io-2.11.0.jar。别乱加无关jar，反而容易引发冲突，只保留官方要求的核心依赖即可。
• 检查IDE配置状态：
  • 用Module Path（Java 9+模块化项目）：确保PDFbox的jar被标记为Automatic Module，同时在module-info.java里声明依赖，比如requires org.apache.pdfbox;
  • 用Classpath（非模块化项目）：确认jar包没有灰色图标、感叹号这类“不可用”标记，右键jar包→Build Path→Add to Build Path，或者移除后重新添加一次
• 验证jar包本身：去Apache官网重新下载PDFbox 3.0.0的二进制包，解压后用里面的jar，避免用损坏的下载文件

二、排查导入方式问题 #

• 核对包路径：PDFbox 3.x的核心类包路径还是org.apache.pdfbox，正确导入示例：

  import org.apache.pdfbox.pdmodel.PDDocument;
  import org.apache.pdfbox.text.PDFTextStripper;
  

  别用旧版本的废弃包路径，否则肯定报错
• 模块化项目特殊检查：如果是Java模块化项目，别在module-info.java里混用模块依赖和非模块化导入，确保所有依赖jar都被识别为模块或自动模块
• 清IDE缓存：IDE缓存可能导致识别异常，试试：
  • Eclipse：执行Project→Clean
  • IDEA：执行Build→Clean Project
    之后重启IDE，重新加载项目结构

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