Java实现Excel转PDF的完整指南：从原理到实战

引言

在企业级应用开发中，Excel文件常被用于数据处理和报表生成，而PDF则因其跨平台性和固定格式成为文档分发的理想选择。使用Java实现Excel到PDF的自动转换，可以显著提升工作效率并减少人工操作错误。

一、技术选型与原理分析

Java中实现Excel转PDF主要有两种技术路径：

• 基于表格绘制：使用Apache POI读取Excel内容，再通过iText等PDF库直接绘制表格，适合简单表格转换。
• 基于模板渲染：先将Excel内容填充到HTML模板，再通过HTML转PDF引擎处理，适合复杂样式保留。

二、使用Apache POI + iText实现转换

2.1 添加依赖

<dependencies>
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi-ooxml</artifactId>
        <version>5.2.3</version>
    </dependency>
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>itext7-core</artifactId>
        <version>7.2.5</version>
        <type>pom</type>
    </dependency>
</dependencies>

2.2 核心代码示例

import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import com.itextpdf.kernel.pdf.PdfDocument;
import com.itextpdf.kernel.pdf.PdfWriter;
import com.itextpdf.layout.Document;
import com.itextpdf.layout.element.Table;

public class ExcelToPdfConverter {
    public static void convert(String excelPath, String pdfPath) throws Exception {
        // 1. 读取Excel
        Workbook workbook = new XSSFWorkbook(new File(excelPath));
        Sheet sheet = workbook.getSheetAt(0);
        
        // 2. 创建PDF文档
        PdfDocument pdfDoc = new PdfDocument(new PdfWriter(pdfPath));
        Document document = new Document(pdfDoc);
        
        // 3. 创建表格
        Table table = new Table(sheet.getLastRowNum());
        for (Row row : sheet) {
            for (Cell cell : row) {
                table.addCell(cell.getStringCellValue());
            }
        }
        
        // 4. 添加到PDF
        document.add(table);
        document.close();
        workbook.close();
    }
}

三、高级功能与优化

实际项目中还需要考虑：

• 样式保留：通过iText的样式API设置字体、颜色、边框等
• 图片处理：使用POI提取图片，再通过iText插入到PDF
• 大数据量优化：采用SXSSFWorkbook处理大文件，使用流式API
• 异常处理：添加文件校验、格式错误捕获等健壮性处理

四、替代方案比较

五、常见问题解决

问题1：中文乱码
解决方案：明确指定字体文件路径，如使用iText的PdfFontFactory.createFont("STSong-Light", "UniGB-UCS2-H")。

问题2：表格分页断裂
解决方案：设置表格的keepTogether属性，或手动处理分页逻辑。

总结

Java实现Excel转PDF需要综合考虑功能需求、性能要求和开发成本。对于简单场景，推荐使用POI+iText的组合；对于复杂报表，可以考虑模板引擎方案。无论选择哪种方式，都需要注意内存管理和异常处理，确保转换过程的稳定性。

通过本文的介绍，开发者应该能够根据具体项目需求，选择合适的工具和方案，快速实现Excel到PDF的可靠转换。