首页 / 新闻资讯 / 使用Apache PDFBox实现Excel到PDF的转换：完整指南与代码示例

使用Apache PDFBox实现Excel到PDF的转换：完整指南与代码示例

发布时间：2026-06-06 作者：崔涛 阅读量：21

在Java开发中，将Excel文件转换为PDF格式是一个常见需求，尤其是在生成报告、打印或归档时。Apache PDFBox作为一个开源的PDF处理库，提供了丰富的API来创建和操作PDF文档。虽然PDFBox本身不直接支持Excel解析，但我们可以结合Apache POI（用于读取Excel）和PDFBox来实现完整的转换流程。

准备工作

首先，确保您的项目中已添加必要的依赖。如果您使用Maven，可以在pom.xml中添加以下配置：

<dependencies>
    <dependency>
        <groupId>org.apache.pdfbox</groupId>
        <artifactId>pdfbox</artifactId>
        <version>2.0.27</version>
    </dependency>
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi-ooxml</artifactId>
        <version>5.2.3</version>
    </dependency>
</dependencies>

实现步骤

以下是将Excel转换为PDF的关键步骤：

  1. 读取Excel文件：使用Apache POI的XSSFWorkbook或HSSFWorkbook类加载Excel文件（.xlsx或.xls格式）。
  2. 提取数据：遍历工作表和单元格，获取文本内容、样式（如字体、颜色）等信息。
  3. 创建PDF文档：使用PDFBox的PDDocument和PDPage类初始化PDF。
  4. 绘制内容：利用PDPageContentStream将Excel数据绘制到PDF页面上，支持文本、表格和简单图形。
  5. 保存PDF文件：最后将生成的PDF文档保存到指定路径。

代码示例

以下是一个简单的Java代码示例，演示如何将Excel文件转换为PDF：

import org.apache.poi.ss.usermodel.*;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import org.apache.pdfbox.pdmodel.*;
import org.apache.pdfbox.pdmodel.common.PDRectangle;
import org.apache.pdfbox.pdmodel.font.PDType1Font;
import org.apache.pdfbox.pdmodel.graphics.image.PDImageXObject;
import java.io.*;

public class ExcelToPdfConverter {
    public static void convert(String excelPath, String pdfPath) throws Exception {
        // 步骤1: 读取Excel文件
        FileInputStream excelFile = new FileInputStream(new File(excelPath));
        Workbook workbook = new XSSFWorkbook(excelFile);
        Sheet sheet = workbook.getSheetAt(0); // 获取第一个工作表
        
        // 步骤2: 创建PDF文档
        PDDocument document = new PDDocument();
        PDPage page = new PDPage(PDRectangle.A4);
        document.addPage(page);
        
        // 步骤3: 绘制内容到PDF
        PDPageContentStream contentStream = new PDPageContentStream(document, page);
        float yPosition = 750; // 初始Y坐标
        
        for (Row row : sheet) {
            contentStream.beginText();
            contentStream.setFont(PDType1Font.HELVETICA, 12);
            contentStream.newLineAtOffset(50, yPosition);
            
            for (Cell cell : row) {
                String cellValue = cell.toString();
                contentStream.showText(cellValue + "  ");
            }
            
            contentStream.endText();
            yPosition -= 20; // 行间距
        }
        
        contentStream.close();
        
        // 步骤4: 保存PDF文件
        document.save(new File(pdfPath));
        document.close();
        workbook.close();
        System.out.println("转换完成！");
    }
    
    public static void main(String[] args) throws Exception {
        convert("input.xlsx", "output.pdf");
    }
}

进阶优化

上述代码为基础版本，您可以根据需求进一步优化：

  • 表格样式：通过绘制线条（使用ContentStream的stroke方法）来增强表格的可视化效果。
  • 多页支持：当Excel数据量大时，自动添加新页面并调整布局。
  • 样式处理：读取单元格的字体、背景色等，并在PDF中还原这些样式。
  • 图像嵌入：如果Excel中包含图片，使用PDImageXObject将其插入PDF。

常见问题与解决方案

在实际使用中，可能会遇到以下问题：

  1. 中文字符显示异常：确保使用支持中文的字体（如思源黑体），并正确加载字体文件。
  2. 内存溢出：处理大文件时，及时关闭工作簿和文档流以释放资源。
  3. 格式对齐：调整坐标计算逻辑，确保PDF中的内容与Excel布局尽量一致。

总结

通过结合Apache PDFBox和POI，您可以高效地将Excel文件转换为PDF。这种方法灵活、可定制，适用于各种企业级应用。如果您需要更复杂的转换（如保留所有Excel样式），可以考虑使用商业库如iText或Aspose，但PDFBox作为免费开源方案，已足够满足大多数基本需求。

希望本文对您的开发有所帮助！如有疑问，欢迎参考Apache PDFBox和POI的官方文档。

相关文章