SpringBoot实现Word转PDF​的完整思路与示例代码详解

 更新时间:2026年05月07日 15:51:47   作者:每日技术  
本文介绍了在SpringBoot中实现将Word转换为PDF的多种方案,包括docx4j、LibreOffice、ApachePOI+iText等主流方案,针对不同需求提供了详细的方案对比,代码示例以及注意事项,希望对大家有所帮助

下面给你一个在 Spring Boot 中实现 Word 转 PDF​ 的完整思路与示例,覆盖主流可行方案推荐做法以及注意事项,你可以按项目需求选择。

一、总体方案对比

方案是否收费转换质量依赖环境推荐指数
docx4j + Plutext PDF Converter商业需授权⭐⭐⭐⭐⭐无(Java)✅✅✅
LibreOffice(命令行)免费⭐⭐⭐⭐需安装LibreOffice✅✅✅
Apache POI + iText(间接)免费⭐⭐复杂
Aspose.Words for Java商业⭐⭐⭐⭐⭐✅(有钱)

生产环境最推荐

  • Windows/Linux 服务器:LibreOffice
  • 企业级高质量:docx4j + Plutext(或 Aspose)

二、方案一:LibreOffice(最常用、免费)

原理

Spring Boot 调用服务器上的 soffice命令将 .docx.pdf

安装 LibreOffice

# Ubuntu
sudo apt install libreoffice
# CentOS
yum install libreoffice
# Windows
下载安装 LibreOffice

Spring Boot 示例代码

Maven 依赖(无需额外)

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter</artifactId>
</dependency>

Service 示例

import java.io.*;

@Service
public class WordToPdfService {

    public void convert(String wordPath, String pdfPath) throws Exception {
        String command = "libreoffice --headless --convert-to pdf "
                + wordPath + " --outdir " + new File(pdfPath).getParent();

        Process process = Runtime.getRuntime().exec(command);
        int exitCode = process.waitFor();

        if (exitCode != 0) {
            throw new RuntimeException("Word转PDF失败");
        }
    }
}

优点

  • 免费
  • 支持 .doc / .docx
  • 格式还原度高

注意

  • Linux 必须安装字体(否则中文乱码)
  • 不支持并发过高(建议队列或限制线程)

三、方案二:docx4j + Plutext(企业级)

Maven 依赖

<dependency>
    <groupId>org.docx4j</groupId>
    <artifactId>docx4j</artifactId>
    <version>11.4.9</version>
</dependency>
<dependency>
    <groupId>org.plutext</groupId>
    <artifactId>plutext-pdf-converter</artifactId>
    <version>3.3.0</version>
</dependency>

转换代码

import org.docx4j.Docx4J;
import org.docx4j.openpackaging.packages.WordprocessingMLPackage;

import java.io.FileOutputStream;

public void convert() throws Exception {
    WordprocessingMLPackage wordMLPackage =
            WordprocessingMLPackage.load(new File("input.docx"));

    Docx4J.toPDF(wordMLPackage, new FileOutputStream("output.pdf"));
}

优点

  • 纯 Java
  • 不依赖外部软件
  • 样式还原好

缺点

  • Plutext 商用需授权
  • 对复杂表格/页眉页脚偶有偏差

四、方案三:Aspose.Words(最强但贵)

Maven

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-words</artifactId>
    <version>23.12</version>
</dependency>

代码示例

import com.aspose.words.Document;

Document doc = new Document("input.docx");
doc.save("output.pdf");

五、常见问题 & 解决方案

中文乱码

Linux 安装中文字体

yum install wqy-microhei-fonts

并发问题

  • LibreOffice 不建议多线程同时转换
  • 可使用线程池 + 队列

Web 接口示例

@PostMapping("/convert")
public ResponseEntity<?> convert(MultipartFile file) throws Exception {
    // 保存word
    // 调用转换
    // 返回pdf流
}

六、推荐选型总结

场景推荐方案
普通后台系统LibreOffice
企业文档系统docx4j + Plutext
金融/合同/报表Aspose.Words

到此这篇关于SpringBoot实现Word转PDF​的完整思路与示例代码详解的文章就介绍到这了,更多相关SpringBoot Word转PDF​内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 解析 MyBatis 中 Mapper 生效的来龙去脉

    解析 MyBatis 中 Mapper 生效的来龙去脉

    这篇文章主要介绍了解析 MyBatis 中 Mapper 生效的前因后果,介绍了mybatis基本使用及源码分析,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-08-08
  • Java Spring-Cache key配置注意事项介绍

    Java Spring-Cache key配置注意事项介绍

    本文主要对java spring-cache key配置注意事项进行了介绍,小编觉得还是挺不错的,这里分享给大家,供需要的朋友参考。
    2017-10-10
  • Spring事务管理配置文件问题排查

    Spring事务管理配置文件问题排查

    这篇文章主要介绍了Spring事务管理配置文件问题排查,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-05-05
  • Java CountDownLatch线程同步源码硬核解析

    Java CountDownLatch线程同步源码硬核解析

    对于并发执行,Java中的CountDownLatch是一个重要的类。为了更好的理解CountDownLatch这个类,本文将通过例子和源码带领大家深入解析这个类的原理,感兴趣的可以学习一下
    2023-01-01
  • Java解决约瑟夫问题代码实例

    Java解决约瑟夫问题代码实例

    这篇文章主要介绍了Java解决约瑟夫(环)问题的代码实例,决约瑟问题貌似经常出现在面试题中,需要的朋友可以参考下
    2014-03-03
  • JVM(Java虚拟机)简介(动力节点Java学院整理)

    JVM(Java虚拟机)简介(动力节点Java学院整理)

    Java虚拟机(Jvm)是可运行Java代码的假想计算机。Java虚拟机包括一套字节码指令集、一组寄存器、一个栈、一个垃圾回收堆和一个存储方法域。对java jvm 虚拟机感兴趣的朋友通过本文一起学习吧
    2017-04-04
  • 从Springboot项目中下载文件的具体过程

    从Springboot项目中下载文件的具体过程

    最近在做一个临时的项目,APP端在检测到程序有更新时,需要去后台下载新的安装包,接下来通过本文给大家分享从Springboot项目中下载文件的具体过程,感兴趣的朋友一起看看吧
    2021-07-07
  • SpringBoot利用模板实现自动生成Word合同的功能

    SpringBoot利用模板实现自动生成Word合同的功能

    这篇文章主要为大家详细介绍了SpringBoot如何利用模板实现自动生成Word合同的功能,文中的示例代码讲解详细,感兴趣的小伙伴可以了解下
    2025-12-12
  • 详解分别用Kotlin和java写RecyclerView的示例

    详解分别用Kotlin和java写RecyclerView的示例

    本篇文章主要介绍了详解分别用Kotlin和java写RecyclerView的示例,详解分别用Kotlin和java写RecyclerView的示例
    2017-12-12
  • Java中使用print、printf、println的示例及区别

    Java中使用print、printf、println的示例及区别

    Java 的输出方式一般有这三种,print、println、printf,它们都是 java.long 包里的System类中的方法,本文重点给大家介绍Java中使用print、printf、println的示例,需要的朋友可以参考下
    2023-05-05

最新评论