首页 / 新闻资讯 / Java实现Excel转PDF：完整指南与最佳实践

Java实现Excel转PDF：完整指南与最佳实践

发布时间：2026-05-31 作者：邓伟 阅读量：15

引言

在许多企业应用中，需要将Excel报表或数据转换为PDF格式以便于存档、分享或打印。Java作为一种跨平台语言，提供了多种库来实现这一功能。本文将系统介绍如何使用Java完成Excel到PDF的转换。

主要方法概述

在Java中实现Excel转PDF主要有以下几种途径：

  • 使用Apache POI读取Excel，结合iText生成PDF：这是最灵活但相对复杂的方式。
  • 使用jasperreports：适合复杂报表，但配置较繁琐。
  • 使用商业库（如Aspose）：功能强大，但需要购买许可。
  • 利用OpenOffice/LibreOffice API：通过命令行或API调用进行转换，需要安装相应软件。

详细实现：Apache POI + iText

以下是一个基本示例，展示如何使用Apache POI读取Excel文件，并使用iText生成PDF。

1. 添加依赖

在Maven项目的pom.xml中添加以下依赖：

<dependencies>
    <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>
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>itext-core</artifactId>
        <version>5.5.13.3</version>
        <type>pom</type>
    </dependency>
</dependencies>

2. 编写转换代码

以下代码读取一个Excel文件（.xlsx），并将每个工作表转换为PDF页面：

import com.itextpdf.text.Document;
import com.itextpdf.text.Font;
import com.itextpdf.text.FontFactory;
import com.itextpdf.text.Paragraph;
import com.itextpdf.text.pdf.PdfWriter;
import org.apache.poi.ss.usermodel.*;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;

import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;

public class ExcelToPdfConverter {
    public static void convert(String excelPath, String pdfPath) throws IOException {
        // 加载Excel文件
        InputStream inputStream = ExcelToPdfConverter.class.getResourceAsStream(excelPath);
        Workbook workbook = new XSSFWorkbook(inputStream);

        // 创建PDF文档
        Document document = new Document();
        PdfWriter.getInstance(document, new FileOutputStream(pdfPath));
        document.open();

        // 设置字体
        Font font = FontFactory.getFont(FontFactory.COURIER, 10);

        // 遍历每个工作表
        for (int i = 0; i < workbook.getNumberOfSheets(); i++) {
            Sheet sheet = workbook.getSheetAt(i);
            document.add(new Paragraph("Sheet: " + sheet.getSheetName(), font));

            // 遍历每一行
            for (Row row : sheet) {
                StringBuilder rowData = new StringBuilder();
                for (int j = 0; j < row.getLastCellNum(); j++) {
                    Cell cell = row.getCell(j);
                    if (cell != null) {
                        rowData.append(cell.toString()).append("\t");
                    }
                }
                document.add(new Paragraph(rowData.toString(), font));
            }
            document.add(new Paragraph("\n"));
        }

        // 关闭文档
        document.close();
        workbook.close();
    }

    public static void main(String[] args) {
        try {
            convert("/input.xlsx", "/output.pdf");
            System.out.println("转换成功！");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

注意：此示例仅处理基本文本内容，不保留Excel的格式（如样式、公式等）。要保留完整格式，需要更复杂的处理逻辑。

使用JasperReports实现更复杂的转换

JasperReports是一个功能强大的报表引擎，它支持从多种数据源生成PDF。要使用它进行Excel转PDF，通常需要先将Excel数据导入到数据源中，然后设计Jasper模板。步骤如下：

  1. 使用Apache POI读取Excel数据并填充到JRDataSource中。
  2. 设计Jasper模板（.jrxml文件），定义PDF的布局。
  3. 使用JasperFillManager生成报表并导出为PDF。

这种方法更适合生成格式统一的报表，而非简单的内容转换。

性能与优化

处理大型Excel文件时，内存管理至关重要：

  • 使用流式API（如SXSSFWorkbook）读取Excel，减少内存占用。
  • 分批处理数据，避免一次性加载整个工作簿。
  • 考虑多线程或异步处理，提升转换速度。

常见问题与解决方案

  • 中文乱码：确保iText使用支持中文的字体（如SimSun）。
  • 格式丢失：简单的文本转换会丢失样式。如需保留，需解析Excel的样式信息并映射到PDF。
  • 内存溢出：优化读取方式，使用SXSSFWorkbook，并适当增加JVM内存（-Xmx参数）。

结论

Java提供了多种实现Excel转PDF的方案。根据项目需求，可以选择简单的文本转换，或使用更专业的库保留格式。Apache POI结合iText是一个常见且免费的选择，适合大多数基本场景。对于复杂报表，JasperReports或商业库可能更合适。开发者应权衡功能、性能和维护成本，选择最适合的解决方案。

相关文章