SpringBoot使用LibreOffice实现高保真Word转PDF的方法

 更新时间:2026年02月01日 11:18:10   作者:星月前端  
本文介绍了在SpringBoot中使用LibreOffce实现高保真Word转PDF的方法,首先详细说明了Windows、Mac、Linux系统及Docker环境下LibreOffice的安装步骤和常见问题解决方案,需要的朋友可以参考下

一、需要先安装LibreOffice

Windows:

访问官网:https://www.libreoffice.org/download/,下载Windows版本安装包,双击运行安装,按提示完成安装,默认安装路径:C:\Program
Files\LibreOffice

Mac:

# 方式1:Homebrew安装
brew install --cask libreoffice

# 方式2:官网下载DMG安装

Linux服务器安装:

1.Ubuntu/Debian

# 更新包列表
sudo apt update

# 安装LibreOffice
sudo apt install libreoffice

# 安装中文字体(可选)
sudo apt install fonts-wqy-zenhei fonts-wqy-microhei

# 验证安装
libreoffice --version

2.CentOS/RHEL:

# 添加EPEL仓库
sudo yum install epel-release

# 安装LibreOffice
sudo yum install libreoffice

# 安装中文字体
sudo yum install wqy-zenhei-fonts

查看安装路径

which libreoffice
# 通常路径:/usr/lib/libreoffice

Docker中安装:

# Dockerfile
FROM openjdk:11-jre-slim

# 安装LibreOffice
RUN apt update && \
    apt install -y libreoffice && \
    apt clean && \
    rm -rf /var/lib/apt/lists/*

# 设置环境变量
ENV OFFICE_HOME=/usr/lib/libreoffice

验证安装是否成功

# 查看版本
libreoffice --version

# 启动服务测试
soffice --headless --accept="socket,host=0.0.0.0,port=2002;urp;" --nofirststartwizard

# 查看进程
ps aux | grep soffice

常见问题解决
字体缺失:

# Linux安装常用字体
sudo apt install fonts-liberation fonts-noto-cjk

端口占用:

# 查看端口占用
netstat -tlnp | grep 2002

# 修改SpringBoot配置中的端口号

内存优化(服务器环境):

# application.yml
jodconverter:
  local:
    max-tasks-per-process: 20  # 根据服务器性能调整
    task-execution-timeout: 120000  # 超时时间(ms)

二、使用示例

添加依赖

<dependency>
    <groupId>org.jodconverter</groupId>
    <artifactId>jodconverter-spring-boot-starter</artifactId>
    <version>4.4.6</version>
</dependency>
<dependency>
    <groupId>org.jodconverter</groupId>
    <artifactId>jodconverter-local</artifactId>
    <version>4.4.6</version>
</dependency>

配置application.yml

jodconverter:
  local:
    enabled: true
    office-home: /usr/lib/libreoffice  # Linux
    # office-home: C:\Program Files\LibreOffice  # Windows
    port-numbers: 2002
    max-tasks-per-process: 100

代码示例:

package com.geofly.geocloud.queryapp.intranet.service;

import org.jodconverter.core.DocumentConverter;
import org.jodconverter.core.office.OfficeException;
import org.springframework.stereotype.Service;

import java.io.File;

/**
 * word转pdf
 */
@Service
public class WordToPdfService {

    private final DocumentConverter documentConverter;

    public WordToPdfService(DocumentConverter documentConverter) {
        this.documentConverter = documentConverter;
    }

    /**
     * word转pdf
     * @param wordFile
     * @param pdfFile
     * @throws OfficeException
     */
    public void wordToPdf(File wordFile, File pdfFile) throws OfficeException {
        documentConverter.convert(wordFile)
                .to(pdfFile)
                .execute();
    }
}

简单使用示例

// 将DOCX转换为PDF
try {
       wordToPdfService.wordToPdf(docxFile, new File(upLoadPath, pdfFilePath));
    } catch (Exception e) {
       OpLogUtil.info("转pdf操作出错了:" + e.getMessage());
       return "转pdf操作出错了:" + e.getMessage() + ",pdfFilePath:" + pdfFilePath;
   }

非常的好用!

注意:

确保系统已安装LibreOffice

默认端口2002,确保端口未被占用

生产环境建议配置连接池参数

以上就是SpringBoot使用LibreOffice实现高保真Word转PDF的方法的详细内容,更多关于SpringBoot LibreOffice高保真Word转PDF的资料请关注脚本之家其它相关文章!

相关文章

  • SpringBoot混合使用StringRedisTemplate和RedisTemplate的坑及解决

    SpringBoot混合使用StringRedisTemplate和RedisTemplate的坑及解决

    这篇文章主要介绍了SpringBoot混合使用StringRedisTemplate和RedisTemplate的坑及解决方案,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-12-12
  • 使用Mybatis-plus实现时间自动填充(代码直接可用)

    使用Mybatis-plus实现时间自动填充(代码直接可用)

    这篇文章主要介绍了使用Mybatis-plus实现时间自动填充(代码直接可用),具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-06-06
  • springboot配置mongodb连接池的方法步骤

    springboot配置mongodb连接池的方法步骤

    这篇文章主要介绍了springboot配置mongodb连接池的方法步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-01-01
  • Java @Validated遇到的大坑与处理

    Java @Validated遇到的大坑与处理

    这篇文章主要介绍了Java @Validated遇到的大坑与处理方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-12-12
  • SpringBoot docker项目部署实战

    SpringBoot docker项目部署实战

    本文主要介绍了SpringBoot docker项目部署实战,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-08-08
  • java实现后台处理base64图片还原为文件

    java实现后台处理base64图片还原为文件

    这篇文章主要介绍了java实现后台处理base64图片还原为文件,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-02-02
  • Java多线程基本用法总结

    Java多线程基本用法总结

    本篇文章主要总结了Java线程的一些基本的用法。具有一定的参考价值,下面跟着小编一起来看下吧
    2017-01-01
  • maven快速生成SpringBoot打包文件的方法步骤

    maven快速生成SpringBoot打包文件的方法步骤

    本文主要介绍了使用Maven快速生成SpringBoot项目打包文件的方法,包括如何生成可执行的JAR文件,如何将配置文件、运行脚本、调试脚本、证书文件等拷贝到指定目录,及如何编译出部署包,这种方法能大大方便微服务的部署,提高部署效率
    2024-10-10
  • SpringBoot启动报错Whitelabel Error Page: This application has no explicit mapping for的解决方法

    SpringBoot启动报错Whitelabel Error Page: This&nbs

    当我们使用Spring Boot框架开发Web应用时,有时会遇到启动报错信息为"Whitelabel Error Page: This application has no explicit mapping for",种报错信息意味着我们的应用缺少某个URL映射的配置,导致请求无法处理,在本篇文章中,我们将详细讨论如何解决这个问题
    2024-03-03
  • java实现手写一个简单版的线程池

    java实现手写一个简单版的线程池

    有些人可能对线程池比较陌生,并且更不熟悉线程池的工作原理。本文就来手写一个简单版的线程池,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-08-08

最新评论