Java中Excel转PDF的完整指南：方法、工具与实战代码

发布时间：2026-08-11 作者：董慧阅读量：2

引言

在企业级应用开发中，经常需要将Excel报表自动转换为PDF格式，以便于归档、打印或跨平台共享。Java作为主流的企业开发语言，提供了多种实现Excel转PDF的解决方案。本文将深入探讨各种技术方案的实现原理、优缺点比较，并提供可直接使用的代码示例。

方案一：Apache POI + iText 组合方案

这是最传统且开源免费的解决方案，适合对成本敏感且有一定技术能力的团队。

1.1 依赖配置

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

1.2 实现代码

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

public class ExcelToPdfConverter {
    public void convert(String excelPath, String pdfPath) throws Exception {
        // 1. 读取Excel文件
        Workbook workbook = WorkbookFactory.create(new File(excelPath));
        Sheet sheet = workbook.getSheetAt(0);
        
        // 2. 创建PDF文档
        PdfWriter writer = new PdfWriter(pdfPath);
        PdfDocument pdfDoc = new PdfDocument(writer);
        Document document = new Document(pdfDoc);
        
        // 3. 创建PDF表格
        Table table = new Table(sheet.getLastRowNum() + 1);
        
        // 4. 遍历Excel单元格并添加到PDF表格
        for (Row row : sheet) {
            for (Cell cell : row) {
                table.addCell(cell.toString());
            }
        }
        
        // 5. 添加表格到文档并关闭
        document.add(table);
        document.close();
        workbook.close();
    }
}

方案二：Spire.XLS 专业库方案

Spire.XLS是专业的Excel处理库，提供了一站式的转换解决方案，代码简洁且转换效果优秀。

2.1 依赖配置

<dependency>
    <groupId>e-iceblue</groupId>
    <artifactId>spire.xls</artifactId>
    <version>14.1.0</version>
</dependency>

2.2 实现代码

import com.spire.xls.Workbook;
import com.spire.xls.FileFormat;

public class SpireExcelToPdf {
    public void convert(String excelPath, String pdfPath) {
        // 创建Workbook对象
        Workbook workbook = new Workbook();
        // 加载Excel文件
        workbook.loadFromFile(excelPath);
        // 转换为PDF
        workbook.saveToFile(pdfPath, FileFormat.PDF);
        workbook.dispose();
    }
}

方案三：在线API方案

对于轻量级应用或不想引入大型依赖的项目，可以考虑使用第三方在线转换API。

// 示例：使用某云服务API
public class CloudExcelToPdf {
    public void convert(String excelUrl, String pdfOutputPath) throws Exception {
        // 1. 上传Excel文件到云存储
        // 2. 调用转换API
        // 3. 下载转换后的PDF
        // 具体实现取决于所选云服务商
    }
}

方案对比与选型建议

方案	优点	缺点	适用场景
Apache POI + iText	完全免费、开源、可控性强	代码复杂、格式保持一般、学习曲线陡峭	成本敏感项目、需要深度定制的场景
Spire.XLS	代码简洁、转换效果好、支持复杂格式	商业授权、有文件大小限制	企业级项目、对转换质量要求高的场景
在线API	无需本地依赖、维护简单	依赖网络、有数据安全风险、成本可能较高	轻量级应用、临时性转换需求

最佳实践与注意事项

性能优化：对于大文件，考虑使用流式处理或分批转换
内存管理：及时关闭工作簿和文档对象，避免内存泄漏
编码处理：确保中文等特殊字符正确显示
样式保持：复杂样式（如条件格式、图表）可能无法完美转换
异常处理：完善的错误处理机制，特别是文件格式异常

总结

Java中实现Excel转PDF有多种成熟方案可供选择。开发者应根据项目具体需求、预算限制和团队技术栈来选择合适的方案。对于大多数企业项目，推荐使用Spire.XLS等专业库以保证转换质量和开发效率；对于开源项目或学习用途，Apache POI + iText的组合仍然是不错的选择。无论选择哪种方案，都需要注意性能优化和异常处理，确保转换过程的稳定性和可靠性。

新闻资讯