在IntelliJ中添加PDFBox到库和模块后为何出现异常错误？

错误原因 #

• 依赖jar不完整：RandomAccessRead属于PDFBox的IO核心模块，若仅添加了pdfbox.jar，会缺少依赖的pdfbox-io.jar（2.x版本的PDFBox拆分了独立的IO模块）。
• 版本不兼容：混用不同版本的PDFBox相关jar包，或jar版本与代码调用的API不匹配，会导致类找不到。
• IDE配置问题：虽在项目结构中添加了jar，但未正确关联到当前模块，或jar包本身损坏、路径无效。

解决办法 #

• 补全依赖jar
  • 手动添加jar时，除pdfbox.jar外，需同步添加同版本的pdfbox-io.jar，以及commons-logging.jar（基础日志依赖）。
  • 优先用构建工具（Maven/Gradle）管理，自动处理依赖：
    Maven示例（pom.xml）：

    <dependency>
        <groupId>org.apache.pdfbox</groupId>
        <artifactId>pdfbox</artifactId>
        <version>2.0.32</version> <!-- 替换为需要的版本 -->
    </dependency>
    

• 统一jar版本
  确保所有PDFBox相关jar版本完全一致，避免版本冲突导致的类缺失。
• 修复IDE库配置
  1. 打开项目结构→库，确认添加的jar已勾选关联到当前模块；
  2. 右键jar包选择「Add as Library」，确保模块能识别到依赖；
  3. 若jar损坏，重新下载官方对应版本的jar包替换。
• 验证代码导入
  确保代码中导入的是正确的PDFBox类：

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

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