使用 Apache POI + iText (纯 Java 开源方案)

这是最传统的纯 Java 方案，通过 Apache POI 读取 Office 文档的内容，再使用 iText 将这些内容重新“绘制”成 PDF。

原理：

• Apache POI: 用于解析 .docx, .xlsx, .pptx 等格式的文件，提取其中的文本、图片、表格等元素。
• iText: 用于创建 PDF 文档，并将 POI 提取的内容按照布局写入 PDF。

优点：

• 纯 Java: 无需安装任何外部软件或依赖操作系统。
• 开源免费: 完全免费,无任何授权限制。
• 灵活性高: 可以对文档内容进行精细的控制和修改。

缺点：

• 样式丢失严重: 这是最大的痛点，POI 读取的是样式信息（如字体、颜色、段落间距等），但用 iText 重新渲染时，很难 100% 还原原始 Office 文档的版式，特别是复杂的表格、页眉页脚、图文混排等,处理起来非常困难。
• 实现复杂: 需要编写大量代码来处理布局,开发成本高。
• 性能一般: 对于大文档,处理速度可能不理想。

适用场景：

• 只需要提取文本内容,对版式要求不高的场景。
• 需要对 Office 文档内容进行深度处理和修改后再生成 PDF。

使用 OpenOffice/LibreOffice (调用外部服务)

这种方案不直接使用 Java 库，而是通过 Java 调用一个本地的 Office 软件（如 LibreOffice，它是 OpenOffice 的一个分支）作为“转换服务”。

原理：

1. 在服务器上安装并运行 LibreOffice。
2. Java 程序通过命令行或其 UNO (Universal Network Objects) 接口，将 Office 文件路径和转换指令发送给 LibreOffice。
3. LibreOffice 在后台完成转换，生成 PDF 文件。
4. Java 程序读取生成的 PDF 文件。

优点：

• 保真度极高: 因为是真正的 Office 软件在进行转换，PDF 的样式、版式、字体等都能得到完美还原。
• 支持格式广泛: 支持 .doc, .docx, .xls, .xlsx, .ppt, .pptx 等几乎所有 Office 格式。
• 开源免费: LibreOffice 本身是免费的。

缺点：

• 依赖外部软件: 必须在服务器上安装并保持 LibreOffice 运行,增加了部署的复杂性。
• 性能瓶颈: 转换过程是异步的，需要等待 LibreOffice 处理，速度较慢，并发转换时需要管理多个 LibreOffice 实例,资源消耗大。
• 稳定性问题: LibreOffice 进程崩溃,会影响整个转换服务。

适用场景：

• 对 PDF 保真度要求极高的场景，如合同、报告等正式文档。
• 转换量不大,对性能要求不高的后台任务。

使用商业库 (如 Aspose, Spire.Office)

这是目前企业级应用中最推荐、最省心的方案，Aspose 和 Spire 是两家非常著名的商业软件公司，它们提供了功能强大的 Java API 专门用于处理 Office 文件。

原理： 这些库是专门为文件格式转换而生的底层库，它们直接解析 Office 文件的二进制结构，并生成符合 PDF 规范的文件,无需调用任何外部程序。

优点：

• 保真度极高: 转换效果与方案二（调用真实 Office）几乎一样，能完美还原版式、字体、图片等。
• 纯 Java 方案: 无需安装任何外部软件，部署简单，只需引入 JAR 包即可。
• 性能优越: 转换速度快，效率高,支持高并发。
• 功能强大: 除了转换，还支持读取、写入、修改、合并、拆分、加解密等多种 Office 文档操作。
• 技术支持完善: 作为商业产品,提供专业的技术支持文档和客服。

缺点：

• 收费: 这是唯一的缺点，需要按开发者数量、服务器数量或使用量购买许可证,不过通常提供免费试用版。

适用场景：

• 企业级应用，对性能、稳定性和保真度有严格要求。
• 项目预算充足，希望快速、高质量地完成功能开发。

使用在线 API (如 Smallpdf, Adobe PDF Services)

如果你的应用允许将文件上传到云端服务,这是一个非常便捷的选择。

原理： 你的 Java 程序将 Office 文件上传到在线转换服务的 API，服务端处理完成后，你再将转换好的 PDF 下载回来。

优点：

• 开发极其简单: 只需要处理 HTTP 请求和响应,无需关心转换逻辑。
• 无需维护: 无需在服务器上安装任何软件,所有维护工作都由服务商负责。
• 可扩展性好: 可以轻松应对高并发的转换请求。

缺点：

• 数据隐私和安全风险: 文件需要上传到第三方服务器,可能涉及敏感数据泄露的风险。
• 依赖网络: 必须保证网络连接稳定。
• 成本和限制: 通常按调用次数收费,或有免费额度限制。
• 可控性差: 转换质量、速度等都由服务商决定。

适用场景：

• Web 应用，特别是 SaaS 产品。
• 对数据隐私要求不高,或者用户已明确同意将数据上传到云端。
• 项目初期快速验证想法。

推荐方案总结与选择

如何选择？

• 新手/个人项目/预算有限，且对版式要求不高：可以尝试 方案一 (Apache POI + iText),但请务必接受样式会丢失的现实。
• 对版式要求极高，且不介意在服务器上部署软件：可以选择 方案二 (调用 LibreOffice)，这是开源方案中的“保真度之王”。
• 企业级项目，追求高效率、高保真度和易部署：强烈推荐方案三 (商业库)，这是目前最平衡、最省心的选择。Aspose 和 Spire.Office 都是业界标杆。
• 开发 Web 应用，希望快速集成，且不介意文件上传到云端：方案四 (在线 API) 是最佳选择，能让你专注于业务逻辑,而不是文件转换。

代码示例

这里为您提供 方案三 (商业库) 中 Aspose.Words 的代码示例,因为它最符合企业级开发需求。

Aspose.Words 示例

步骤 1: 获取 JAR 包 你可以从 Aspose 官网 下载 JAR 包，或者在 Maven 仓库中添加依赖。

Maven 依赖:

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-words</artifactId>
    <version>23.8</version> <!-- 请使用最新版本 -->
</dependency>

步骤 2: Java 代码

import com.aspose.words.*;
public class OfficeToPdfConverter {
    public static void main(String[] args) {
        // 设置 Aspose.Words 的许可证（如果使用付费版，需要取消注释并配置）
        // setLicense();
        String docPath = "input.docx"; // 你的 Word 文档路径
        String pdfPath = "output.pdf"; // 生成的 PDF 文档路径
        try {
            // 加载 Word 文档
            Document doc = new Document(docPath);
            // 保存为 PDF
            // SaveFormat.PDF 指定了保存为 PDF 格式
            doc.save(pdfPath, SaveFormat.PDF);
            System.out.println("文档已成功转换为 PDF: " + pdfPath);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
    /**
     * 设置 Aspose.Words 的许可证文件
     * license.xml 文件需要从 Aspose 官网下载
     */
    private static void setLicense() {
        try {
            // InputStream 是从 classpath 或文件系统加载 license.xml
            InputStream license = OfficeToPdfConverter.class.getResourceAsStream("/license.xml");
            License aposeLicense = new License();
            aposeLicense.setLicense(license);
            System.out.println("Aspose.Words License Set Successfully.");
        } catch (Exception e) {
            e.printStackTrace();
            System.out.println("There was an error setting the Aspose.Words License.");
        }
    }
}

调用 LibreOffice 示例

步骤 1: 安装 LibreOffice 在你的服务器上安装并运行 LibreOffice，确保它在监听一个 socket 接口,或者你可以在命令行模式下调用它。

步骤 2: Java 代码

import java.io.File;
public class LibreOfficeConverter {
    public static void main(String[] args) {
        String officeFilePath = "input.docx";
        String outputDir = "output_directory";
        String outputFile = "output.pdf";
        // 构建命令
        // soffice --headless --convert-to pdf --outdir "output_directory" "input.docx"
        String[] command = {
            "soffice", // LibreOffice 的命令行程序名
            "--headless", // 无界面模式
            "--convert-to", // 转换格式
            "pdf", // 转换为 pdf
            "--outdir", // 输出目录
            outputDir,
            officeFilePath // 要转换的文件
        };
        try {
            // 执行命令
            Process process = Runtime.getRuntime().exec(command);
            // 等待命令执行完成
            int exitCode = process.waitFor();
            if (exitCode == 0) {
                System.out.println("转换成功！");
                // LibreOffice 会生成一个同名的 pdf 文件
                File pdfFile = new File(outputDir, new File(officeFilePath).getName().replace(".docx", ".pdf"));
                System.out.println("PDF 文件已生成于: " + pdfFile.getAbsolutePath());
            } else {
                System.err.println("转换失败，退出码: " + exitCode);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

希望这份详细的指南能帮助您在 Java 项目中顺利实现 Office 转 PDF 的功能！