方案概览

纯Java方案 (Apache POI + iText) - 不推荐

这是最“原生”的Java方案，但也是最痛苦的方案，它本质上是：

1. 用 Apache POI 解析 .docx 或 .xlsx 文件，提取出文本、段落、表格、图片等数据。
2. 用 iText 创建一个PDF文件，然后将POI提取的数据“手动”写入PDF，并重新设置样式。

问题：

• 样式丢失严重：字体、颜色、页边距、分页等很难精确还原。
• 表格和图片定位困难：在PDF中精确控制表格和图片的位置和大小非常复杂。
• 性能差：解析和重新生成文档的开销很大。

除非你的需求只是提取纯文本，否则强烈不推荐使用此方案进行转换。

使用商业库 (推荐，效果最好)

这是最推荐的方案，因为它简单、高效、效果好，以 Aspose.Words 为例，它被誉为“Office操作的瑞士军刀”。

准备工作

• 下载JAR包：从 Aspose官网 下载最新版的 aspose-words-xx.x-jdk.jar。
• 添加依赖 (Maven):

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

• 获取许可证：免费版会在转换后的PDF每页顶部添加一个水印，生产环境需要购买许可证，你可以通过代码设置一个临时许可证来进行测试。

Java 代码示例

转换非常简单,只需一行核心代码。

import com.aspose.words.*;
import java.io.*;
public class OfficeToPdfWithAspose {
    public static void main(String[] args) {
        // 1. 设置许可证（可选，但推荐）
        // 你可以从一个文件加载许可证，或者使用环境变量等
        try {
            License asposeLicense = new License();
            asposeLicense.setLicense("Aspose.Words.Java.lic"); // 将你的许可证文件放在项目根目录下
        } catch (Exception e) {
            System.out.println("License error, running in evaluation mode.");
        }
        // 2. 指定源文件和目标文件路径
        String sourceDocPath = "input.docx"; // 可以是 .docx, .doc, .xlsx, .pptx 等
        String pdfOutputPath = "output.pdf";
        // 3. 加载文档
        Document doc = new Document(sourceDocPath);
        // 4. 保存为PDF (核心代码！)
        doc.save(pdfOutputPath, SaveFormat.PDF);
        System.out.println("转换成功！PDF文件已保存到: " + pdfOutputPath);
    }
}

优点：

• 代码极简：加载，保存，一行搞定。
• 保真度高：能完美还原字体、颜色、图片、表格、页眉页脚、分栏等几乎所有格式。
• 性能优秀：转换速度快，内存占用相对合理。
• 功能强大：除了转PDF，还能进行文档合并、拆分、水印、加密等复杂操作。

调用外部服务 (LibreOffice)

如果你的项目预算有限,但又不想忍受纯Java方案的痛苦，可以使用开源的 LibreOffice 或 OpenOffice 作为“后台引擎”。

准备工作

• 安装LibreOffice：在你的服务器上安装 LibreOffice。
• 了解其命令行：LibreOffice可以通过命令行启动，并使用 --convert-to 参数进行转换。

Java 代码示例

通过Java的 Runtime.exec() 方法来执行命令行。

import java.io.*;
public class OfficeToPdfWithLibreOffice {
    public static void main(String[] args) {
        String sourceFile = "input.docx";
        String outputFile = "output.pdf";
        String libreOfficePath = "C:/Program Files/LibreOffice/program/soffice.exe"; // Windows 示例
        // String libreOfficePath = "/usr/bin/libreoffice"; // Linux 示例
        try {
            // 构建命令
            // --headless: 无界面模式运行
            // --convert-to pdf: 指定转换目标格式为pdf
            // --outdir: 指定输出目录
            ProcessBuilder pb = new ProcessBuilder(
                libreOfficePath,
                "--headless",
                "--convert-to", "pdf",
                "--outdir", new File(outputFile).getParent(),
                sourceFile
            );
            // 启动进程
            Process process = pb.start();
            // 等待进程执行完成
            int exitCode = process.waitFor();
            if (exitCode == 0) {
                System.out.println("转换成功！");
            } else {
                // 读取错误流
                BufferedReader reader = new BufferedReader(new InputStreamReader(process.getErrorStream()));
                String line;
                StringBuilder errorMsg = new StringBuilder();
                while ((line = reader.readLine()) != null) {
                    errorMsg.append(line).append("\n");
                }
                System.err.println("转换失败，错误码: " + exitCode);
                System.err.println("错误信息: " + errorMsg.toString());
            }
        } catch (IOException | InterruptedException e) {
            e.printStackTrace();
        }
    }
}

优点：

• 免费且效果好：转换质量接近商业库，能处理复杂文档。
• 支持格式广泛：支持几乎所有Office格式。

缺点：

• 依赖外部软件：服务器必须安装并维护LibreOffice。
• 性能和稳定性：启动JVM和Office进程需要时间，不适合高并发的实时转换。
• 跨平台配置：不同操作系统下LibreOffice的路径和配置可能不同。

调用云服务

如果你的应用是Web应用,或者需要处理大量文档，云服务是很好的选择。

选择云服务商

• Google Docs API: 可以将文件上传到Google Drive，然后调用API进行转换。
• Microsoft Graph API: 如果你使用的是Microsoft 365，可以利用其强大的文档转换能力。
• 专业云转换服务: 如 PDFShift, CloudConvert 等，它们通常提供专门的API，非常稳定易用。

通用流程

1. 注册并获取API Key：在云服务商的控制台注册账号，获取API密钥。
2. 上传Office文件：将你的Office文件上传到云服务商的存储或直接作为请求体发送。
3. 调用转换API：发送HTTP请求到转换接口，带上你的API Key和文件信息。
4. 下载PDF文件：API处理完成后，获取转换后的PDF文件URL或直接下载。

优点：

• 高可用和可扩展：无需关心服务器维护。
• 功能丰富：通常还提供OCR、压缩、签名等附加功能。
• 按需付费：通常根据使用量计费，成本可控。

缺点：

• 网络依赖：必须联网才能使用。
• 数据隐私：文档需要经过第三方服务器，需评估其安全性。
• 成本：对于大量转换，费用可能较高。

总结与建议

如何选择？

• 企业级应用，预算充足，追求最佳体验：首选商业库 (Aspose)，它能为你节省大量的开发、测试和维护时间，转换质量有保障。
• 个人项目或预算有限，能接受部署复杂度：使用LibreOffice方案，它提供了一个不错的免费替代品。
• Web应用或SaaS产品：考虑云服务，它能让你专注于业务逻辑，将转换这种基础设施工作交给专业的服务商。
• 千万不要选择纯Java方案，除非你的需求只是提取文本，并且对格式完全不在乎。