SpringBoot+EasyPOI轻松实现Excel和Word导出PDF_Java

在企业级开发中，将 excel 和 word 文档导出为 pdf 是常见需求（如报表归档、合同存档）。本文将结合 easypoi（excel 快速导出） 和 aspose 系列工具（格式完美转换），详细讲解如何实现 excel 和 word 到 pdf 的转换，并解决格式保留、性能优化等核心问题。

一、环境准备与依赖配置

1.1 方案选型

步骤	工具/库	特点	适用场景
excel 生成	easypoi（阿里）	基于 apache poi 优化，支持注解快速生成 excel，内存占用低	数据量中等（十万行以内）
excel 转 pdf	aspose.cells（商业）	完美保留 excel 格式（字体、颜色、合并单元格、图表等），性能强	企业级高精度转换需求
word 生成	apache poi（xwpf）	开源，支持 .docx 格式，需手动处理复杂样式	简单 word 文档（文本+表格）
word 转 pdf	aspose.words（商业）	完美保留 word 格式（样式、图片、页眉页脚等），兼容性强	企业级高精度转换需求

1.2 依赖配置（商业库方案）

注意：aspose 系列工具需购买商业许可证（试用版有水印），测试阶段可使用免费试用版。

在 pom.xml 中添加依赖：

<dependencies>
    <!-- spring boot web -->
    <dependency>
        <groupid>org.springframework.boot</groupid>
        <artifactid>spring-boot-starter-web</artifactid>
    </dependency>
    
    <!-- easypoi（excel 导出） -->
    <dependency>
        <groupid>cn.afterturn</groupid>
        <artifactid>easypoi-base</artifactid>
        <version>4.4.0</version> <!-- 最新稳定版 -->
    </dependency>
    <dependency>
        <groupid>cn.afterturn</groupid>
        <artifactid>easypoi-web</artifactid>
        <version>4.4.0</version>
    </dependency>
    
    <!-- aspose.cells（excel 转 pdf） -->
    <dependency>
        <groupid>com.aspose</groupid>
        <artifactid>aspose-cells</artifactid>
        <version>23.10</version>
    </dependency>
    
    <!-- aspose.words（word 转 pdf） -->
    <dependency>
        <groupid>com.aspose</groupid>
        <artifactid>aspose-words</artifactid>
        <version>23.10</version>
    </dependency>
</dependencies>

二、excel 导出 pdf 实现（easypoi + aspose.cells）

2.1 定义 excel 实体类（easypoi 注解）

使用 easypoi 的注解简化 excel 生成逻辑，支持标题、表头、数据校验等：

@data
@tablename("sys_employee")
// excel 导出配置（文件名、工作表名）
@excelentity(name = "员工信息表", sheetname = "员工信息")
public class employee {
    @excel(name = "id", ordernum = "0", width = 10)  // 列名、顺序、列宽
    private long id;

    @excel(name = "姓名", ordernum = "1", width = 15)
    private string name;

    @excel(name = "年龄", ordernum = "2", width = 10, replace = {"0_未知", "1_男", "2_女"})  // 数据替换
    private integer gender;

    @excel(name = "部门", ordernum = "3", width = 20)
    private string department;

    @excel(name = "入职时间", ordernum = "4", width = 20, format = "yyyy-mm-dd")  // 日期格式
    private date hiredate;
}

2.2 excel 生成工具类（easypoi）

编写工具类，封装 easypoi 的 excel 导出逻辑，生成 workbook 对象：

@component
public class excelexportutils {
    private static final logger log = loggerfactory.getlogger(excelexportutils.class);

    /**
     * 生成 excel workbook（基于 easypoi）
     * @param datalist 数据列表
     * @param entityclass 实体类（含 @excelentity 注解）
     * @return workbook
     */
    public static <t> workbook generateexcelworkbook(list<t> datalist, class<t> entityclass) {
        exportparams exportparams = new exportparams();
        exportparams.setsheetname("员工信息");  // 工作表名（与 @excelentity 一致）
        exportparams.settitle("员工信息表");    // excel 标题（顶部大标题）

        // 使用 easypoi 生成 workbook
        return excelexportutil.exportexcel(exportparams, entityclass, datalist);
    }
}

2.3 excel 转 pdf 工具类（aspose.cells）

使用 aspose.cells 加载 excel 的 workbook，并转换为 pdf 字节流，保留所有格式：

@component
public class exceltopdfconverter {
    private static final logger log = loggerfactory.getlogger(exceltopdfconverter.class);

    /**
     * 将 workbook 转换为 pdf 字节流（aspose.cells）
     * @param workbook excel workbook
     * @return pdf 字节流
     */
    public static bytearrayoutputstream converttopdf(workbook workbook) throws exception {
        // 1. 创建 pdf 保存选项（可选配置）
        pdfsaveoptions saveoptions = new pdfsaveoptions();
        saveoptions.setonepagepersheet(true);       // 每个工作表一页
        saveoptions.setformat(pdfformat.pdfa2b);    // 符合 pdf/a-2b 标准（可选）
        saveoptions.setcompressimages(true);        // 压缩图片（减小文件大小）
        saveoptions.setimagecompression(pdfimagecompressiontype.medium);  // 图片压缩级别

        // 2. 转换为 pdf 字节流
        bytearrayoutputstream pdfoutputstream = new bytearrayoutputstream();
        workbook.save(pdfoutputstream, saveoptions);
        return pdfoutputstream;
    }
}

2.4 controller 层整合（excel 导出 pdf）

编写接口，接收请求后生成 excel 并转换为 pdf 下载：

@restcontroller
@requestmapping("/export")
public class exportcontroller {
    @autowired
    private excelexportutils excelexportutils;
    @autowired
    private exceltopdfconverter pdfconverter;

    @getmapping("/excel-to-pdf")
    public void exportemployeetopdf(httpservletresponse response) throws exception {
        // 1. 模拟数据（实际从数据库查询）
        list<employee> datalist = new arraylist<>();
        datalist.add(new employee(1l, "张三", 25, "技术部", new date()));
        datalist.add(new employee(2l, "李四", 30, "市场部", new date()));

        // 2. 生成 excel workbook（easypoi）
        workbook workbook = excelexportutils.generateexcelworkbook(datalist, employee.class);

        // 3. 转换为 pdf 字节流（aspose.cells）
        bytearrayoutputstream pdfoutputstream = pdfconverter.converttopdf(workbook);

        // 4. 设置响应头（下载 pdf）
        response.setcontenttype("application/pdf");
        response.setheader("content-disposition", "attachment; filename=employee_report.pdf");
        response.getoutputstream().write(pdfoutputstream.tobytearray());
        response.getoutputstream().flush();
        response.getoutputstream().close();
    }
}

三、word 导出 pdf 实现（easypoi + aspose.words）

3.1 定义 word 模板（freemarker 或直接生成）

word 文档生成通常使用 模板引擎（如 freemarker），通过替换模板中的占位符生成内容。这里以 aspose.words 直接生成简单 word 为例：

@component
public class worddocumentbuilder {
    private static final logger log = loggerfactory.getlogger(worddocumentbuilder.class);

    /**
     * 构建 word 文档（aspose.words）
     * @param content 文档内容（文本+表格）
     * @return document（aspose.words 文档对象）
     */
    public static document buildworddocument(string content) throws exception {
        // 创建空白文档
        document doc = new document();
        documentbuilder builder = new documentbuilder(doc);

        // 写入标题
        builder.getfont().setname("微软雅黑");
        builder.getfont().setsize(16);
        builder.getfont().setbold(true);
        builder.writeln("员工信息报告");

        // 写入正文
        builder.getfont().setsize(12);
        builder.getfont().setbold(false);
        builder.writeln("以下是近期员工信息：");
        builder.writeln();

        // 写入表格（示例数据）
        builder.starttable();
        builder.insertcell();
        builder.write("id");
        builder.insertcell();
        builder.write("姓名");
        builder.insertcell();
        builder.write("部门");
        builder.endrow();

        builder.insertcell();
        builder.write("1");
        builder.insertcell();
        builder.write("张三");
        builder.insertcell();
        builder.write("技术部");
        builder.endrow();

        builder.endtable();

        return doc;
    }
}

3.2 word 转 pdf 工具类（aspose.words）

使用 aspose.words 将生成的 word 文档转换为 pdf，保留样式、图片等：

@component
public class wordtopdfconverter {
    private static final logger log = loggerfactory.getlogger(wordtopdfconverter.class);

    /**
     * 将 aspose.words document 转换为 pdf 字节流
     * @param document word 文档对象
     * @return pdf 字节流
     */
    public static bytearrayoutputstream converttopdf(document document) throws exception {
        // 1. 配置 pdf 保存选项（可选）
        pdfsaveoptions saveoptions = new pdfsaveoptions();
        saveoptions.setcompressfonts(true);       // 压缩字体
        saveoptions.setusehighqualityrendering(true);  // 高质量渲染

        // 2. 转换为 pdf 字节流
        bytearrayoutputstream pdfoutputstream = new bytearrayoutputstream();
        document.save(pdfoutputstream, saveoptions);
        return pdfoutputstream;
    }
}

3.3 controller 层整合（word 导出 pdf）

编写接口，生成 word 文档并转换为 pdf 下载：

@restcontroller
@requestmapping("/export")
public class exportcontroller {
    @autowired
    private worddocumentbuilder wordbuilder;
    @autowired
    private wordtopdfconverter wordpdfconverter;

    @getmapping("/word-to-pdf")
    public void exportemployeetopdf(httpservletresponse response) throws exception {
        // 1. 构建 word 文档（aspose.words）
        string content = "员工信息报告内容...";  // 实际从数据库或业务逻辑获取
        document worddoc = wordbuilder.buildworddocument(content);

        // 2. 转换为 pdf 字节流（aspose.words）
        bytearrayoutputstream pdfoutputstream = wordpdfconverter.converttopdf(worddoc);

        // 3. 设置响应头（下载 pdf）
        response.setcontenttype("application/pdf");
        response.setheader("content-disposition", "attachment; filename=employee_report.pdf");
        response.getoutputstream().write(pdfoutputstream.tobytearray());
        response.getoutputstream().flush();
        response.getoutputstream().close();
    }
}

四、关键问题与优化

4.1 格式保留问题

excel：aspose.cells 支持所有 excel 特性（合并单元格、条件格式、图表、公式等），转换后与原文档一致。
word：aspose.words 支持样式（字体、颜色、段落）、图片、页眉页脚、目录等，复杂排版（如多栏、文本框）也能完美保留。

4.2 性能优化

大数据量 excel：若数据量超过 10 万行，建议使用 easypoi 的 @excelentity 配合分页查询，避免内存溢出。
pdf 压缩：通过 pdfsaveoptions 配置图片压缩（pdfimagecompressiontype）和字体嵌入策略，减小文件体积。

4.3 免费方案替代（libreoffice）

若无法使用商业库，可通过调用 libreoffice 命令行实现转换（需服务器安装 libreoffice）：

// 调用 libreoffice 转换 excel 到 pdf
public static void convertexceltopdfwithlibreoffice(string excelpath, string pdfpath) throws ioexception {
    string command = string.format(
        "libreoffice --headless --convert-to pdf --outdir %s %s",
        pdfpath, excelpath
    );
    process process = runtime.getruntime().exec(command);
    int exitcode = process.waitfor();
    if (exitcode != 0) {
        throw new runtimeexception("libreoffice 转换失败");
    }
}

注意：此方法格式保留可能不完整（如复杂样式丢失），仅适用于小型项目。

五、总结

本文通过 easypoi 生成 excel/word + aspose 系列工具转换 pdf 的方案，实现了 spring boot 中 excel 和 word 到 pdf 的完整流程。aspose 工具在格式保留和性能上表现优异，适合企业级高精度需求；若预算有限，可尝试 libreoffice 命令行方案（需接受格式限制）。实际项目中需根据数据量和格式要求选择合适方案。

以上就是springboot+easypoi轻松实现excel和word导出pdf的详细内容，更多关于springboot excel和word导出pdf的资料请关注代码网其它相关文章！

SpringBoot+EasyPOI轻松实现Excel和Word导出PDF

2025年07月19日 • Java •我要评论