一、 背景

因为项目中需要使用word转pdf功能，因为转换速度原因，最后选用了libreoffice，原因及部署请参考

linux ubuntu环境安装libreoffice，word转pdf

远程调用的话可选docker部署，请看2.3.1

二、springboot整合libreoffice

其实springboot整合libreoffice有两种方式，一种是使用本地的libreoffice，一种是使用远程服务的libreoffice（这个好多文章中没有提到，也是自己踩的坑算是）

2.1、整合本地服务

引入pom

<code> <dependency>

<groupId>org.jodconverter</groupId>

<artifactId>jodconverter-spring-boot-starter</artifactId>

<version>4.4.2</version>

</dependency>

<dependency>

<groupId>org.jodconverter</groupId>

<artifactId>jodconverter-local</artifactId>

<version>4.4.2</version>

</dependency>

yml配置

jodconverter:

local:

enabled: true

#window地址: D:\\workplaces\\jcxx\\libreoffice 请自行补全

#linux地址: /opt/libreoffice24.2

office-home: /opt/libreoffice24.2

# 端口（线程）

portNumbers: [8101,8102,8103]

maxTasksPerProcess: 100

# 任务执行的超时时间

task-execution-timeout: 360000

# 任务队列的超时时间

task-queue-timeout: 360000

# 一个进程的超时时间

process-timeout: 360000

使用也很简单

@Resource

private DocumentConverter documentConverter;

public void test() {

//流转换

documentConverter.convert(inputStream).as(DefaultDocumentFormatRegistry.DOCX).to(outStream).as(DefaultDocumentFormatRegistry.PDF).execute();

//文件转换,sourceFile和targetFile都是File类实例

documentConverter.convert(sourceFile).to(targetFile).as(DefaultDocumentFormatRegistry.PDF).execute();

}

2.2、整合远程服务

说一下怎么发现的，学过springboot的应该都知道，整合其他服务时候应该都有个配置类xxxAutoConfiguration

于是发现了除了一个local外，还有个remote，才发现可以直接调用远程服务，发现了那就可以整合使用，如下

pom引入

<code> <dependency>

<groupId>org.jodconverter</groupId>

<artifactId>jodconverter-spring-boot-starter</artifactId>

<version>4.4.2</version>

</dependency>

<dependency>

<groupId>org.jodconverter</groupId>

<artifactId>jodconverter-remote</artifactId>

<version>4.4.2</version>

</dependency>

yml配置

jodconverter:

remote:

enabled: true

url: http://192.168.1.16:8100

ssl:

enabled: false

注意，一定要加http，我就不小心忽略了这个东西，只写了个ip+端口，结果导致一致报错

java.net.MalformedURLException: no protocol

以下可不看，直接看踩坑

使用方式和local的一样，参考上面

不过比local方式多了一步，要手动启动远程的libreoffice服务

启动命令,附上对应命令的含义

https://help.libreoffice.org/latest/zh-CN/text/shared/guide/start_parameters.html

soffice --headless --nologo --nofirststartwizard --norestore --accept="socket,host=0.0.0.0,port=8100;urp;" &code>

以为到此就结束了吗？不不不，是我想的太简单了

对了，上面的命令还踩了一些坑，百度的时候都是127.0.0.1，想telnet通的的话需要使用0.0.0.0，不过，纠结这个似乎没啥意义，原因似乎不在这里（当时还花了好久排查）

不用0.0.0.0的话，直接报错连不上对应ip端口，改了之后报下面的错

2.3、整合远程服务踩坑

于是又开始找，不过这回学聪明了点，只在github中的issues中找，搜索关键词<code>remote

还真让我找出来两种办法：但是我只成功了一种

对了，扔几个issues链接，有兴趣的可以看下

https://github.com/jodconverter/jodconverter/wiki/Migration-Guide-4.4.5

https://github.com/jodconverter/jodconverter/issues/40

https://github.com/jodconverter/jodconverter/issues/350

https://github.com/jodconverter/jodconverter/issues/397

2.3.1、方法一（成功）

也就是https://github.com/jodconverter/jodconverter/issues/397这个里面提到的方案。代码很简单，都可以看下，简单来说就是本地启动一个libreoffice服务，并对外提供接口调用（就一个controller）

docker镜像拉不下来参考这个，我是看第一点成功的https://blog.csdn.net/weixin_50160384/article/details/139861337

jodconverter提供了一个远程服务的接口，我们可以直接docker运行

docker run -d -p 8100:8100 --privileged=true -v /usr/share/fonts:/usr/share/fonts -v /opt/application.properties:/etc/app/application.properties ghcr.io/jodconverter/jodconverter-examples:rest

挂载对应字体，否则中文不显示

-v /usr/share/fonts:/usr/share/fonts

挂载配置文件，用于修改端口等

-v /opt/application.properties:/etc/app/application.properties

配置文件在这看https://github.com/jodconverter/docker-image-jodconverter-examples

对应文件我也贴下

# amount of libreOffice instances to start - one for each given port. So this means 2

jodconverter.local.port-numbers: 2002, 2003

# change the tmp folder

jodconverter.local.working-dir: /tmp

# change upload sizes

spring.servlet.multipart.max-file-size: 5MB

spring.servlet.multipart.max-request-size: 5MB

# change the server port (where the REST app is listenting

server.port=8100

然后这个的ip+端口号使用jodconverter.remote方式就成功了

也许有同学已经安装好了libreoffice，想着我这libreoffice不白装了，最后用docker。。。

其实也不然，可以自己将项目打个包放到服务器去运行，不过这个需要自己研究下了

https://github.com/jodconverter/jodconverter-samples

不过我看了下dockerfile文件，可能是这个命令（没用过gradlew ）

2.3.2、使用local参数，但是使用远程服务器（失败）

根据<code>https://github.com/jodconverter/jodconverter/wiki/Migration-Guide-4.4.5描述及https://github.com/jodconverter/jodconverter/issues/40，似乎可以使用local来进行访问

于是，有了如下配置

jodconverter:

local:

enabled: true

office-home: D:\\workplaces\\libreoffice

port-numbers: 9999

load-document-mode: remote

start-fail-fast: true

host-name: 120.46.141.243

有一点很让人费解，使用了remote模式，还必须配置office-home。。。我使用远程服务上的地址还不行。。。还有一点，必须要提前启动位于服务器上的9999端口服务，不提前启动程序启动不起来。

然后我尝试了下，虽然也能转换成功，但是用了40多秒。

不清楚是什么原因，解决的小伙伴可以在评论区讨论下

soffice --headless --nologo --nofirststartwizard --norestore --accept="socket,host=0.0.0.0,port=9999;urp;" &code>

三、docker中同时部署应用和libreoffice（不推荐）

<code>docker build -t新镜像名字:TAG.

不推荐的原因就是在于此，一个镜像高达1g。。。

实测后libreoffice和服务都是正常的，可以接受镜像大和构建时间长些的也可以使用这种方式

发现这点后，我感觉这也太low了，毕竟之前jar包也就将近200m，而且使用的是阿里的云效流水线构建工具，这样构建一次得花多久？（没有去公司服务器尝试，自己用云服务器尝试，第一次构建dockerfile拉取libreoffice花了得10多分钟，第二次用dockerfile构建就是秒拉取了，可能也只是第一次慢？不知道用云效如何？有兴趣的可以尝试下）。

尝试着找别的方法解决，于是无意中发现了JodConverterRemoteAutoConfiguration，对应配置类

<code>JodConverterRemoteProperties

四、其他问题

4.1、使用远程的libreoffice时候用excel转pdf的时候样式错乱

本来是这样的格式

变成了这样

反正发现这个问题我是很懵圈的。但没办法，排查呗。

尝试下本地的libreoffice另存为是正常的。

尝试下代码本地的libreoffice也是正常的。

尝试下inux的本地的libreoffice也是正常的。

然后我就开始怀疑是不是remote源码层面的问题，于是去把remote的代码弄到本地试了下，也是正常的。

然后我就想着用自己买的服务器试试，是不是application配置文件的问题，但是，我发现，<code>我自己服务器的远程服务是正常的。

那我就意识到了，都是docker容器，不一样的只能是挂载文件，那问题就只能出在字体上了，因为用服务器试过word转pdf没有中文乱码问题（之前有人上传了一些字体），所以服务器上我就没有上传字体，于是就出现了该问题，字体还是要上传全的。

问题就出在字体上，上传上去字体就好了