在 CentOS 上使用 LibreOffice 进行 PDF 转换
一 安装与准备
- 安装 EPEL 仓库并更新索引（如尚未安装）：sudo yum install epel-release && sudo yum update。随后安装无头组件与常用依赖：sudo yum install libreoffice-headless cairo cups-libs libSM。若命令未找到，可安装桌面套件包：sudo yum install libreoffice。安装完成后可用 libreoffice --help 验证可用性。为获得较新版本，也可从官网下载 RPM 包解压后在 RPMS 目录执行 yum localinstall *.rpm 进行安装。
二 命令行快速转换
- 基本用法：将单个文件转换为 PDF 并指定输出目录。示例：libreoffice --headless --convert-to pdf input.docx --outdir /tmp。也可批量转换：mkdir -p pdfs && libreoffice --headless --convert-to pdf *.docx --outdir pdfs。若需指定导出过滤器，可使用：–convert-to pdf:writer_pdf_Export（对 Writer 文档更明确）。转换后的 PDF 默认与源文件同名并写入 --outdir 指定目录。
三 中文乱码与字体配置
- 常见原因是服务器缺少 Windows 字体（如宋体、黑体）。将 Windows 的 C:\Windows\Fonts 中常用字体（如 simsun.ttc、msyh.ttc 等）复制到 Linux 的 /usr/share/fonts/ 下（建议新建目录，例如 /usr/share/fonts/chinese 或 /usr/share/fonts/windowsFont）。然后执行：mkfontscale、mkfontdir、fc-cache -fv 刷新字体缓存，并用 fc-list | grep -i simsun 等确认字体已就绪。之后重新执行转换命令，中文即可正常显示。
四 服务化与并发控制
- 为提高并发与性能，可启动 LibreOffice 的 UNO 监听服务，再用脚本或程序调用：启动命令示例：libreoffice --headless --accept=“socket,host=127.0.0.1,port=2002;urp;” --nofirststartwizard。Python UNO 示例（需事先启动上述服务）：使用 uno 与 PropertyValue 连接到 localhost:2002，desktop.loadComponentFromURL 打开文档，调用 storeToURL 导出为 PDF，最后 dispose 关闭文档。注意：同一时间仅应运行一个 UNO 监听进程；转换任务较多时建议串行化或使用队列，避免多个 soffice 实例争用导致异常。
五 常见问题排查
- 命令未找到或路径异常：若通过 RPM 安装，二进制通常位于 /opt/libreofficeX.Y/program/soffice，可用 /opt/libreofficeX.Y/program/soffice --headless --convert-to pdf … 执行；也可创建软链接或在 PATH 中加入相应目录。依赖缺失报错（如 libcairo.so.2）：安装 cairo、cups-libs、libSM 等依赖后重试。转换卡住或无响应：检查是否已有 soffice.bin 进程残留（top/ps），必要时 kill 后重启转换；批量或高并发场景建议采用单实例服务化方式控制并发。转换质量与版本相关：复杂排版在不同 LibreOffice 版本上表现可能不同，必要时升级版本并查看日志定位问题。