Apache PDFBox中PDDocument.load()方法无法识别的问题求助

• PDFBox版本不兼容：PDFBox 1.x和2.x的API存在明显差异，若你使用的版本与代码写法不匹配（比如用2.x依赖却写1.x的代码，反之亦然），会导致load方法无法被识别。
• 依赖缺失或配置错误：未正确引入PDFBox核心依赖，导致IDE无法找到PDDocument类及对应的load方法。
• 导入语句错误：导入了非org.apache.pdfbox.pdmodel.PDDocument的同名类，比如其他第三方库的类。
• IDE缓存问题：IDE缓存未更新，导致已正确引入的依赖无法被识别。

• 确认PDFBox版本并匹配代码：
  • 若使用PDFBox 2.x，确保导入语句为：import org.apache.pdfbox.pdmodel.PDDocument;，你的load(File)写法在2.x版本中是合法的。
  • 若使用PDFBox 1.x，load(File)方法同样存在，但需确保依赖版本对应1.x（如1.8.16）。
• 修正依赖配置：
  Maven项目添加核心依赖：

  <dependency>
      <groupId>org.apache.pdfbox</groupId>
      <artifactId>pdfbox</artifactId>
      <version>2.0.32</version> <!-- 替换为最新稳定版 -->
  </dependency>
  

  Gradle项目添加：

  implementation 'org.apache.pdfbox:pdfbox:2.0.32'
  

• 清理IDE缓存：
  • IntelliJ IDEA：执行File -> Invalidate Caches / Restart
  • Eclipse：执行Project -> Clean
• 尝试替代加载方式：
  若直接加载File仍有问题，改用FileInputStream加载：

  try (FileInputStream fis = new FileInputStream(new File(originalFormFilePath))) {
      PDDocument originalDocument = PDDocument.load(fis);
      // 表单填写逻辑
      originalDocument.save(outputFilePath);
      originalDocument.close();
  } catch (IOException e) {
      e.printStackTrace();
  }
  

• iText 7：
  主流PDF处理库，表单填写示例：

  try (PdfDocument pdfDoc = new PdfDocument(new PdfReader(originalFormFilePath), new PdfWriter(outputFilePath))) {
      PdfAcroForm form = PdfAcroForm.getAcroForm(pdfDoc, true);
      Map<String, PdfFormField> fields = form.getFormFields();
      // 设置字段值，替换为你的表单字段名和内容
      fields.get("username").setValue("John Doe");
      fields.get("email").setValue("john@example.com");
      // 可选：扁平化表单，防止后续编辑
      form.flattenFields();
  } catch (IOException e) {
      e.printStackTrace();
  }
  

• PDFClown：
  开源PDF处理库，支持表单操作，核心逻辑为加载文档后获取表单字段并赋值。
• Apache PDFBox表单填写完整流程（参考）：
  若成功加载文档，完整的表单填写代码示例：

  try (PDDocument doc = PDDocument.load(new File(originalFormFilePath))) {
      PDAcroForm form = doc.getDocumentCatalog().getAcroForm();
      if (form != null) {
          // 设置字段值
          PDTextField textField = (PDTextField) form.getField("fieldName");
          textField.setValue("填写内容");
      }
      doc.save(outputFilePath);
  } catch (IOException e) {
      e.printStackTrace();
  }
  

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