最近项目需要做在线预览文档功能，要求对word文档后台转为pdf，遇到了很多问题，因此记录一下。

网上有很多将Word转换成PDF的方式，这里我试了几种比较简单的方式：POI、aspose、spire和documents4j。

1、POI

POI是Apache下的一个Java类库，可以帮助我们实现Java与各种Office格式文件的互相转换。下面是实现步骤：

引入依赖

<dependency><groupId>org.apache.poi</groupId><artifactId>poi</artifactId><version>4.1.2</version></dependency> <dependency><groupId>org.apache.poi</groupId><artifactId>poi-ooxml</artifactId><version>4.1.2</version></dependency> <dependency><groupId>com.itextpdf</groupId><artifactId>itextpdf</artifactId><version>5.5.13.2</version></dependency>

工具类代码：

import java.io.FileInputStream;import java.io.FileOutputStream;import java.io.IOException;import org.apache.poi.xwpf.usermodel.XWPFDocument;import org.apache.poi.xwpf.usermodel.XWPFParagraph;import org.apache.poi.xwpf.usermodel.XWPFRun;import org.apache.poi.xwpf.usermodel.XWPFTable;import org.apache.poi.xwpf.usermodel.XWPFTableCell;import org.apache.poi.xwpf.usermodel.XWPFTableRow;import org.apache.poi.xwpf.usermodel.XWPFDocument;import org.apache.poi.xwpf.usermodel.XWPFParagraph;import org.apache.poi.xwpf.usermodel.XWPFRun;import com.lowagie.text.Document;import com.lowagie.text.DocumentException;import com.lowagie.text.pdf.PdfWriter;public class WordToPdfConverter {public static void convertToPdf(String inputFilePath, String outputFilePath) {try {// 加载Word文档FileInputStream fis = new FileInputStream(inputFilePath);XWPFDocument document = new XWPFDocument(fis); // 创建PDF文档Document pdfDoc = new Document();PdfWriter.getInstance(pdfDoc, new FileOutputStream(outputFilePath));pdfDoc.open(); // 将Word文档内容写入PDF文档for (XWPFParagraph paragraph : document.getParagraphs()) {pdfDoc.add(paragraph.createRun().getText());} for (XWPFTable table : document.getTables()) {for (XWPFTableRow row : table.getRows()) {for (XWPFTableCell cell : row.getTableCells()) {pdfDoc.add(cell.getText());}}} pdfDoc.close();document.close(); System.out.println("Word文档已成功转换为PDF！");} catch (IOException | DocumentException e) {e.printStackTrace();}} public static void main(String[] args) {String inputFilePath = "input.docx";String outputFilePath = "output.pdf";convertToPdf(inputFilePath, outputFilePath); }}

POI库在转换过程中无法完全保留Word文档的所有样式。POI库的主要目标是处理Word文档的内容，而不是完全复制其样式。因此，转换后的PDF文件可能会有一些样式差异。如果是比较复杂的Word不建议使用此方式

2、Aspose.Words

Aspose.Words for Java是一个原生库，为开发人员提供了丰富的功能来创建、编辑和转换 Word、PDF、Web 文档，而无需在系统上安装 Microsoft Word 环境。该 Java 库是依赖于文档对象模型 (DOM) 的类和方法的集合，使开发人员能够在元素级别直接访问文档的内部工作方式。使用我们的产品，Java 开发人员可以高效地创建复杂的文档并修改其格式、布局和内容。
对于寻求综合工具来简化文档编辑和文档生成任务的开发人员来说，这个原生 Java API 是一个可靠的文档处理解决方案；大规模自动化文档密集型业务流程；减少人工干预、错误和延迟。

官网：https://products.aspose.com/words/java/

引入依赖(建议将jar包下载下来并上传私服里去)

https://releases.aspose.com/java/repo/com/aspose/aspose-words/18.6/aspose-words-18.6-jdk16.jar

<dependency><groupId>com.aspose</groupId><artifactId>aspose-words</artifactId><version>18.6</version><classifier>jdk16</classifier></dependency>

需要在项目里加入一个license.xml，不然生成的pdf会有水印

license.xml如下：

<License><Data><Products><Product>Aspose.Total for Java</Product><Product>Aspose.Words for Java</Product></Products><EditionType>Enterprise</EditionType><SubscriptionExpiry>20991231</SubscriptionExpiry><LicenseExpiry>20991231</LicenseExpiry><SerialNumber>8bfe198c-7f0c-4ef8-8ff0-acc3237bf0d7</SerialNumber></Data><Signature>sNLLKGMUdF0r8O1kKilWAGdgfs2BvJb/2Xp8p5iuDVfZXmhppo+d0Ran1P9TKdjV4ABwAgKXxJ3jcQTqE/2IRfqwnPf8itN8aFZlV3TJPYeD3yWE7IT55Gz6EijUpC7aKeoohTb4w2fpox58wWoF3SNp6sK6jDfiAUGEHYJ9pjU=</Signature></License>

代码如下：

import java.io.FileInputStream;import java.io.FileOutputStream;import java.io.IOException;import com.aspose.words.Document;import com.aspose.words.License;import com.aspose.words.FontSettings;import com.aspose.words.SaveFormat;public static boolean asposeWordToPdf() {if (!getLicense()) { // 验证License 若不验证则转化出的pdf文档会有水印产生return false;}String inPath = "D:\\GoogleDownload\\ExportWord_230803_032555.docx";String outputFilePath = "C:\\Users\\WPC\\Desktop\\test.pdf";FileOutputStream os = null;try {long old = System.currentTimeMillis();File file = new File(outputFilePath); // 新建一个空白pdf文档os = new FileOutputStream(file);com.aspose.words.Document doc = new Document(inPath); // Address是将要被转化的word文档//Linux 下使用字体库//FontSettings fontSettings = new FontSettings();//fontSettings.setFontsFolder("/usr/share/fonts/windows"+File.separator,true);//doc.setFontSettings(fontSettings);doc.save(os, SaveFormat.PDF);// 全面支持DOC, DOCX, OOXML, RTF HTML, OpenDocument, PDF,// EPUB, XPS, SWF 相互转换long now = System.currentTimeMillis();System.out.println("pdf转换成功，共耗时：" + ((now - old) / 1000.0) + "秒"); // 转化用时} catch (Exception e) {e.printStackTrace();return false;}finally {if (os != null) {try {os.flush();os.close();} catch (IOException e) {e.printStackTrace();}}}return true;}public static boolean getLicense() {boolean result = false;try {InputStream is = Test.class.getClassLoader().getResourceAsStream("\\license.xml"); // license.xml应放在资源路径下License aposeLic = new License();aposeLic.setLicense(is);result = true;} catch (Exception e) {e.printStackTrace();}return result;}

当文档中含有中文字符时，该段代码的执行需要调用操作系统的本地字体库支持，否则所有中文字符都将乱码。

该段代码如果想要在Linux服务器上完美运行，需要给Linux服务器安装中文字体库。可以看最后Java使用Spire.Pdf或Aspose-Words实现Word转换Pdf在Linux服务器上的中文乱码问题

3、spire.doc.free

Spire.Doc for Java是一个专业的 Word API，它使 Java 应用程序能够创建、转换、操作和打印 Word文档，而无需依赖 Microsoft Word。通过使用这个多功能库，开发人员可以轻松处理大量任务，例如插入图像、超链接、 数字签名、书签和水印、设置页眉和页脚、创建表格、设置背景图像以及添加脚注和尾注。此外，Spire.Doc for Java 支持从Word 到 PDF、XPS、Image、EPUB、HTML、TXT、ODT、RTF、WordML、WordXML 等文件格式转换。

注意：免费版Free Spire.Doc for Java 仅限于 500 个段落和 25 个表格。在读取或写入文件期间会强制执行此限制。将Word文档转换为PDF和XPS文件时，您只能获取PDF文件的前3页。

官网：https://www.e-iceblue.com/Introduce/doc-for-java.html

下载 Spire.Doc for Java 开始免费试用：https://www.e-iceblue.com/Download/doc-for-java.html

引入依赖：

<repositories><repository><id>com.e-iceblue</id><url>https://repo.e-iceblue.cn/repository/maven-public/</url></repository></repositories><dependency><groupId>e-iceblue</groupId><artifactId>spire.doc.free</artifactId><version>5.2.0</version></dependency>

代码如下：

import com.spire.doc.FileFormat;private static void spireWordToPdf() throws IOException {//实例化Document类的对象com.spire.doc.Document doc = new com.spire.doc.Document();// 下载Word文件//URL url = new URL("http://xxxx/ExportWord_230724_172956.docx");//InputStream inputStream = url.openStream();//doc.loadFromStream(inputStream,FileFormat.Docx);//加载Worddoc.loadFromFile("D:\\GoogleDownload\\ExportWord_230803_032555.docx");//保存为PDF格式doc.saveToFile("C:\\Users\\WPC\\Desktop\\test.pdf", FileFormat.PDF);}

该段代码如果想要在Linux服务器上完美运行，需要给Linux服务器安装中文字体库。可以看最后Java使用Spire.Pdf或Aspose-Words实现Word转换Pdf在Linux服务器上的中文乱码问题

4、documents4j

官网:https://documents4j.com/#/

GitHub:https://github.com/documents4j/documents4j

documents4j 是一个跨平台的文档转换库，并且可以在 Linux 上进行 Word 转 PDF 的操作。

它利用 Microsft Office 的 APIs 来进行文档转换，因此需要在Linux上安装 OpenOffice/LibreOffice 编辑器。

以下是在Linux环境下执行 Word 转 PDF 的基本步骤：

Ubuntu：使用以下命令安装

sudo apt-get install libreoffice

CentOS：使用以下命令安装

sudo yum install libreoffice

引入依赖：

<dependency><groupId>com.documents4j</groupId><artifactId>documents4j-local</artifactId><version>1.0.3</version></dependency><dependency><groupId>com.documents4j</groupId><artifactId>documents4j-transformer-msoffice-word</artifactId><version>1.0.3</version></dependency>

代码如下：

import com.documents4j.api.DocumentType;import com.documents4j.api.IConverter;import com.documents4j.job.LocalConverter;public static void word2pdf() throws IOException {// 参考：https:blog.csdn.net/ka3p06/article/details/125476270 通过documents4j实现InputStream docxInputStream = null;OutputStream outputStream = null;try {// 原word地址//docxInputStream = new FileInputStream("E:\\\\test2\\\\word模板.docx");URL url = new URL("http://xxxx/ExportWord_230724_172956.docx");docxInputStream = url.openStream();// 转换后pdf生成地址outputStream = new FileOutputStream("C:\\Users\\WPC\\Desktop\\test.pdf");IConverter converter = LocalConverter.builder().build();converter.convert(docxInputStream).as(DocumentType.DOCX).to(outputStream).as(DocumentType.PDF).execute();// 关闭converter.shutDown();// 关闭outputStream.close();// 关闭docxInputStream.close();} catch (Exception e) {System.out.println("[documents4J] word转pdf失败:" + e.toString());} finally {if (outputStream != null) {outputStream.close();}if (docxInputStream != null) {docxInputStream.close();}}}

Java使用Spire.Pdf或Aspose-Words实现Word转换Pdf在Linux服务器上的中文乱码问题

原因分析：

当Word文档中含有中文字符时，不管是使用Spire.Pdf或Aspose-Words实现Word转换Pdf，代码的执行都需要调用操作系统的本地字体库支持，否则所有中文字符都将乱码。

在Windows环境下没有问题但是在Linux环境下有问题，说明不是代码或者输入输出流编码的问题，根本原因是两个平台环境的问题。出现乱码说明Linux环境中没有相应的字体以供使用

如果你的代码想要在Linux服务器上完美运行，就需要给Linux服务器安装中文字体库

解决方案:

将转换无问题的Windows主机中的字体拷贝到Linux平台下进行安装，重启服务器后转换就不会出现乱码

Windows字体复制到Linux环境并安装

Windows字体库的位置是C:\Windows\fonts，这里面包含所有Windows下可用的字体

Linux字体库的位置是 /usr/share/Fonts

在该目录下新建一个目录，比如目录名叫 windows，然后将 Windows 字体库中你要的字体文件复制到新建的目录下(只需要复制*.ttc，和*.ttf格式的文件)

更改这些字体库的权限

sudo chmod 755 /usr/share/fonts/windows/*

然后进入Linux字体库

cd /usr/share/fonts/windows/

接着根据当前目录下的字体建立scale文件。PS：如果提示找不到这个命令，使用：yum install mkfontscale

sudo mkfontscale

接着建立dir文件。PS：如果提示找不到这个命令，使用：yum install fontconfig

sudo mkfontdir

然后运行

sudo fc-cache

最后需要重启一次服务器

如果是docker环境下

重复上面操作，不过进入的服务器是宿主机

**docker run -v /usr/share/fonts:/usr/share/fonts *****
docker启动时共享宿主机的字体库重启docker项目即可解决乱码问题