Java Excel转PDF方案分享

在企业数据报表场景中，Excel转PDF是实现文档安全分发的刚需。传统的Apache POI需配合PDFBox才能实现格式转换，不仅开发流程复杂，还易出现样式丢失、布局错位等问题。这里分享Spire.XLS for Java方案，支持直接输出高保真PDF，无需安装Office环境，保留原表格的公式、图表、样式等核心元素。3行代码即可完成基础转换。

一、开发环境准备

必要环境

JDK 1.8+ （推荐JDK 17）
Maven项目（Gradle配置可参考官方文档）

添加依赖

xml 复制代码

  <repositories>
    <repository>
        <id>com.e-iceblue</id>
        <name>e-iceblue</name>
        <url>https://repo.e-iceblue.com/nexus/content/groups/public/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>e-iceblue</groupId>
        <artifactId>spire.xls</artifactId>
        <version>15.7.7</version>
    </dependency>
</dependencies>

二、基础转换实现

2.1 完整工作簿转PDF

typescript 复制代码

import com.spire.xls.*;

public class ExcelToPDF {
    public static void main(String[] args) {
        // 加载Excel文件
        Workbook workbook = new Workbook();
        workbook.loadFromFile("财务报表.xlsx");        
        
        // 转换为PDF，保留完整工作表
        workbook.saveToFile("output.pdf", FileFormat.PDF);
        
        // 释放资源
        workbook.dispose();
    }
}

注意事项

支持.xls和.xlsx格式输入
若需禁止分页，通过workbook.getConverterSetting().setSheetFitToPage(true)将页面内容缩放到1页

2.2 精准区域转PDF

通过Worksheet.getPageSetup().setPrintArea()指定输出范围，避免全表冗余：

scss 复制代码

// 选取Sheet1
Worksheet sheet = workbook.getWorksheets().get(0);

// 选取Sheet1的A1到F20区域
sheet.getPageSetup().setPrintArea("A1:F20");

// 执行区域转换
sheet.saveToPdf("区域报表.pdf",);

参数	配置方法	推荐场景
页面方向	setOrientation()	宽表（如横向财务报表）
缩放比例	setZoom()	小字号内容放大
边距控制	setTopMargin() (上边距)	最大化打印区域

三、企业级场景解决方案

3.1 批量转换优化

使用线程池+资源释放提升吞吐量：

ini 复制代码

ExecutorService executor = Executors.newFixedThreadPool(4);
List<Path> excelFiles = getBatchFiles(); // 假设获取批量文件路径

for (Path file : excelFiles) {
    executor.execute(() -> {
        Workbook wb = new Workbook();
        try {
            wb.loadFromFile(file.toString());
            wb.saveToFile(file + ".pdf", FileFormat.PDF);
        } finally {
            wb.dispose(); // 必须释放，避免内存泄漏
        }
    });
}

3.2 动态水印与LOGO

通过页眉插入企业标识+日期：

java 复制代码

PageSetup page = sheet.getPageSetup();
page.setLeftHeader("&"Calibri"&12&KFF0000 " + 
                   LocalDate.now() + " 机密文件"); // 红色字体水印

// 添加LOGO（需图片本地路径）
page.setLeftHeaderImage("logo.png");
page.setLeftHeader("&G"); // &G表示图片占位符

【实践建议】

异常处理清单

异常类型	排查方向
FileNotFoundException	检查输入路径权限及空格转义
OutOfMemoryError	分批处理大文件，及时dispose