大家好，我是Java1234_小锋老师。

Apache PDFBox 是一个用 Java 编写的开源 PDF 处理库，既能创建新文档，也能读取、修改已有 PDF，还能从中提取文字与数据。

一、PDF 处理，为什么成了刚需？

日常工作中，PDF 几乎无处不在：合同归档、发票打印、报表导出、电子签章……很多系统都需要在后台默默地处理 PDF——合并几份文件、从合同里抠出文字、把扫描件转成图片，或者给文档盖上电子章。

过去，这类需求往往依赖商业软件或闭源组件，授权贵、集成麻烦，出了问题也不太好查。于是，越来越多团队开始转向开源、免费、可嵌入业务代码的方案。在这个背景下，Apache PDFBox 走进了更多开发者的视野。

二、PDFBox 是什么？

Apache PDFBox是 Apache 软件基金会旗下的开源 Java 库，专门用来读写和操作 PDF 文件。

你可以把它理解成：给 Java 程序装了一个「PDF 工具箱」。不用打开 Adobe，也不用额外装桌面软件，直接在代码里就能完成大部分 PDF 相关任务。

几个关键信息：

作为 Apache 顶级项目，PDFBox 有稳定的发布节奏和社区支持，这也是它区别于「个人小工具库」的重要原因。

三、为什么越来越多人选它？

1. 完全开源，成本可控

PDFBox 采用 Apache 2.0 协议，个人项目、企业内部系统都可以放心使用，不必为按席位或按调用次数的授权费发愁。对预算有限、又需要深度集成 PDF 能力的团队来说，这一点很有吸引力。

2. 和 Java 生态天然合拍

国内大量后端、中间件、企业级应用都是 Java 技术栈。PDFBox 纯 Java 实现，通过 Maven 或 Gradle 引入即可，和 Spring Boot、微服务、批处理任务都能无缝配合，不需要为了 PDF 再单独搭一套环境。

3. 功能覆盖面广，「一个库」解决多数场景

从创建 PDF、合并拆分，到表单填写、文字提取、转图片、数字签名、PDF/A 校验……常见需求基本都能在一个库里找到对应能力，减少了「东拼西凑多个 SDK」的维护成本。

4. 自带命令行工具，开发调试都方便

除了 API，PDFBox 还提供了若干命令行小工具，适合快速验证想法、做批处理脚本，或者在运维场景下临时处理文件。

5. 社区活跃，文档齐全

官方站点提供入门指南、示例和 API 文档；GitHub 上也能看到持续的版本更新与问题讨论。遇到问题，查文档、搜 Issue，通常都能找到线索。

四、PDFBox 能做什么？

根据 官方介绍，PDFBox 主要支持以下能力：

• 提取文字：从 PDF 中读取 Unicode 文本，便于检索、归档、数据分析
• 合并与拆分：把多个 PDF 合成一个，或把大文件按页拆开
• 表单处理：读取 PDF 表单字段，或向表单里填入数据
• 格式校验：按 PDF/A-1b 等标准检查文件是否符合规范
• 打印与渲染：配合 Java 打印 API 输出，或将页面保存为 PNG、JPEG 等图片
• 从零创建 PDF：嵌入字体、插入图片，生成新文档
• 数字签名：为 PDF 添加电子签名，满足合规与防伪需求

这些能力覆盖了办公自动化、档案系统、财务票据、合同管理等典型业务场景。

五、典型使用流程

下面是一个常见的业务处理流程：用户上传 PDF，后端用 PDFBox 完成解析与转换，再输出结果。

六、怎么上手？

如果你已经熟悉 Java，跟着下面这个最小示例，大约 10 分钟就能跑通第一个 PDFBox 程序。示例做了两件事：创建一份 PDF，再把里面的文字读出来——不依赖现成的 PDF 文件，复制代码即可运行。

第一步：引入依赖

在 Maven 项目的pom.xml中加入 PDFBox 依赖（版本号以 官网 最新发布为准）：

<dependency><groupId>org.apache.pdfbox</groupId><artifactId>pdfbox</artifactId><version>3.0.8</version></dependency>

第二步：编写入门 Demo

新建PdfBoxQuickStart.java，完整代码如下：

importorg.apache.pdfbox.Loader;importorg.apache.pdfbox.pdmodel.PDDocument;importorg.apache.pdfbox.pdmodel.PDPage;importorg.apache.pdfbox.pdmodel.PDPageContentStream;importorg.apache.pdfbox.pdmodel.font.PDType1Font;importorg.apache.pdfbox.pdmodel.font.Standard14Fonts;importorg.apache.pdfbox.text.PDFTextStripper;importjava.io.File;importjava.io.IOException;/** * PDFBox 入门示例：创建 PDF 并提取文字 */publicclassPdfBoxQuickStart{publicstaticvoidmain(String[]args)throwsIOException{// 1. 创建一份简单的 PDFFilepdfFile=newFile("hello.pdf");createSimplePdf(pdfFile);System.out.println("PDF 已生成："+pdfFile.getAbsolutePath());// 2. 读取 PDF 中的文字Stringtext=extractText(pdfFile);System.out.println("提取到的文字：");System.out.println(text);}/** * 创建包含一行文字的 PDF 文件 */privatestaticvoidcreateSimplePdf(FileoutputFile)throwsIOException{try(PDDocumentdocument=newPDDocument()){PDPagepage=newPDPage();document.addPage(page);// 在页面上写入文字try(PDPageContentStreamstream=newPDPageContentStream(document,page)){stream.beginText();stream.setFont(newPDType1Font(Standard14Fonts.FontName.HELVETICA),24);stream.newLineAtOffset(100,700);stream.showText("Hello, PDFBox!");stream.endText();}document.save(outputFile);}}/** * 从 PDF 文件中提取全部文字 */privatestaticStringextractText(FilepdfFile)throwsIOException{// PDFBox 3.x 使用 Loader.loadPDF() 加载文档（2.x 时代的 PDDocument.load() 已废弃）try(PDDocumentdocument=Loader.loadPDF(pdfFile)){PDFTextStripperstripper=newPDFTextStripper();stripper.setSortByPosition(true);// 按从左到右、从上到下排序，阅读更自然returnstripper.getText(document);}}}

小提示：PDFBox 3.x 加载 PDF 请用Loader.loadPDF()，不要再用旧版的PDDocument.load()。

第三步：运行并查看结果

在项目根目录执行：

# 编译javac-cp"target/dependency/*"PdfBoxQuickStart.java# 运行（Maven 项目可先执行 mvn dependency:copy-dependencies 把 jar 拷到 target/dependency）java-cp".;target/dependency/*"PdfBoxQuickStart

如果用 IDE（IntelliJ IDEA、Eclipse 等），直接右键运行main方法即可。

预期输出：

PDF 已生成：D:\demo\hello.pdf 提取到的文字： Hello, PDFBox!

同时，项目目录下会多出一个hello.pdf，用任意 PDF 阅读器打开就能看到刚才写入的内容。

第四步：接下来学什么？

跑通这个 Demo 后，可以按业务需求继续深入：

七、写在最后

PDF 不会消失，反而在政务、金融、医疗、电商等领域用得越来越深。开发者需要的，是一个可靠、开放、能长期维护的 PDF 处理方案。

Apache PDFBox 正好满足了这几点：Apache 背书、Java 原生、功能完整、社区持续更新。如果你正在做 Java 项目，又绕不开 PDF，不妨花一个下午读读官方文档、写几个小 demo——很可能你会发现，它正是你一直在找的那把「PDF 瑞士军刀」。