springboot实现word转换pdf

下面给你一个在 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(最常用、免费)

1️⃣ 原理

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

2️⃣ 安装 LibreOffice

bash 复制代码
# Ubuntu
sudo apt install libreoffice

# CentOS
yum install libreoffice

# Windows
下载安装 LibreOffice

3️⃣ Spring Boot 示例代码

Maven 依赖(无需额外)

xml 复制代码
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter</artifactId>
</dependency>

Service 示例

arduino 复制代码
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(企业级)

1️⃣ Maven 依赖

xml 复制代码
<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>

2️⃣ 转换代码

java 复制代码
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

xml 复制代码
<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-words</artifactId>
    <version>23.12</version>
</dependency>

代码示例

ini 复制代码
import com.aspose.words.Document;

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

✅ 转换效果最好

❌ 商业授权昂贵


五、常见问题 & 解决方案

✅ 中文乱码

  • Linux 安装中文字体

    yum install wqy-microhei-fonts

✅ 并发问题

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

✅ Web 接口示例

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

六、推荐选型总结

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

如果你愿意,我可以:

  • ✅ 给你写一个 完整的 Spring Boot Demo
  • ✅ 封装成 工具类
  • ✅ 处理 Word 模板 → PDF
  • ✅ 解决 Linux 中文乱码

你可以直接告诉我:你的部署环境 + 是否有预算 + 是否要模板。

相关推荐
Lanwarf-前端开发6 小时前
Vue3 + Canvas/WebGL 雷达扫描可视化实战:PPI、RHI、VOL、SVOL 四种模式原理与实现
前端·javascript·vue.js·webgl
学长毕设6 小时前
基于SpringBoot的儿童慈善捐赠管理系统-附源码
java·spring boot·后端
FRing037 小时前
vue3干货总结2(vue3生命周期、父子通信、模版引用、provide和inject)
开发语言·前端·vue.js·vue3
皮皮林5517 小时前
GitHub Copilot:你可以暂时不用,但别不知道它有多强
后端
学长毕设7 小时前
基于SpringBoot非遗文化展示与传播平台设计与实现-附源码
java·spring boot·后端
杨凯凡8 小时前
Spring Boot SSE 上线后不实时、频繁断线?Nginx 缓冲、心跳与连接回收实战
spring boot·后端·nginx
锋行天下8 小时前
langgraph 全栈项目(三)
前端·人工智能·后端
金銀銅鐵9 小时前
用 Swing 重做操作数栈演示
java·jvm·后端
锋行天下9 小时前
langgraph 全栈项目(二)
前端·人工智能·后端
锋行天下10 小时前
langgraph全栈项目(一)
前端·人工智能·后端