LibreOffice 服务器 Excel 转 PDF 字体差异化问题深度排查与根治方案

近期线上遇到一个典型的服务器环境字体兼容疑难问题：两台配置、业务逻辑完全一致的 CentOS 服务器，均部署 LibreOffice 用于 Excel 批量转 PDF 业务，却出现了完全不同的字体表现。本文完整复盘本次问题排查、环境对比、配置落地的全过程，完整记录多轮问题定位与最终解决方案，适配 YUM 官方默认 LibreOffice 环境，规避网上各类错误路径与无效配置。

一、问题现象：两台服务器字体表现差异化异常

本次涉及两台业务服务器，均使用 LibreOffice headless 模式实现 Excel 导出 PDF 功能，前期均存在中文兼容隐患，后续通过安装 Google Noto 中文字体进行修复，但两台机器修复结果完全不一致：

服务器 A：初始导出 PDF 中文乱码，安装 Google Noto CJK 字体后，乱码问题彻底解决，PDF 字体正常渲染、显示美观，完全符合业务预期。

服务器 B：初始导出 PDF 无中文乱码，但是默认渲染字体为系统黑体（SimHei）；手动安装全套 Google Noto 字体后，导出 PDF 依旧强制显示黑体 ，Noto 字体完全不生效，字体替换失败。

两台服务器软件、转换命令、业务代码完全一致，仅字体渲染结果存在差异，属于典型的系统字体优先级与 LibreOffice 内部字体映射机制导致的隐性兼容问题。

二、问题根源深度定位

通过逐行排查系统字体库、字体优先级、LibreOffice 版本与配置路径，最终定位核心差异原因：

服务器 A：系统初始 无任何中文黑体（SimHei）字库文件 ，系统无中文兜底字体。安装 Noto 字体后，系统与 LibreOffice 无备选中文字体，自动 fallback 调用 Noto Sans CJK SC 渲染，因此字体正常生效。

服务器 B：系统预装了 Windows 兼容黑体字库 SimHei。Excel 文档内大量文本字体标记为「黑体/SimHei」， LibreOffice 内部字体映射优先级高于系统默认字体配置 ，只要本地存在对应字体文件，会优先匹配文档标记字体，不会主动切换为后安装的 Noto 字体，最终出现装了 Noto 依旧显示黑体的现象。

同时排查确认，两台服务器均为 YUM 官方安装的 LibreOffice 5.4 版本，无自定义 /opt 安装目录，网络上多数针对 /opt 路径的 xcu 配置方案完全不适用，这也是前期配置无效的关键原因之一。

三、前置环境校验与字体状态核查

为精准确认环境差异，本次排查执行了标准化字体校验命令，明确两台机器字体差异：

1. 校验系统是否存在黑体字库：执行如下命令区分两台服务器环境差异

# 检查英文黑体字库
fc-list | grep -i simhei

# 检查中文黑体字库
fc-list | grep -i "黑体"

服务器 B 有完整输出，服务器 A 无任何结果，精准定位环境差异根源。

2. 校验 Noto 字体安装状态：通过以下命令验证字体完整性

# 校验 Noto 中文字体是否正常安装
fc-list | grep "Noto Sans CJK SC"

两台服务器均有完整输出，确认谷歌开源中文字体无缺失、无损坏。

3. 校验 LibreOffice 安装路径：通过如下命令确认版本与安装目录，排除错误配置路径

# 查看 libreoffice 安装路径
whereis libreoffice

确认环境为标准 YUM 安装路径： /usr/bin/libreoffice 、 /usr/lib64/libreoffice 、 /usr/share/libreoffice ，无 /opt 自定义安装目录，彻底排除非适配配置。

四、分层根治方案落地（全环境适配）

针对 LibreOffice 字体匹配优先级高于系统字体、已有字体优先渲染的核心机制，采用「系统全局字体拦截 + LibreOffice 用户级字体替换 + 转换命令兜底」三层方案，彻底覆盖所有场景，强制所有黑体字体映射为 Noto Sans CJK SC。

4.1 系统全局 Fontconfig 强制字体映射

通过系统级字体配置，全局拦截所有程序对「黑体、SimHei」的调用，强制替换为 Noto 字体，优先级覆盖所有应用软件。配置文件为 /etc/fonts/local.conf ，可直接复制使用完整配置：

<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd"&gt;
&lt;fontconfig&gt;
    <!-- 强制系统所有调用黑体英文名称 映射 Noto -->
    <alias binding="same">
        <family>SimHei</family>
        <accept>
            <family>Noto Sans CJK SC</family>
        </accept>
    &lt;/alias&gt;
    <!-- 强制系统所有调用黑体中文名称 映射 Noto -->
    <alias binding="same">
        <family>黑体</family>
        <accept>
            <family>Noto Sans CJK SC</family>
        </accept>
    </alias&gt;
    <!-- 系统默认无衬线中文字体统一 Noto -->
    <alias>
        <family>sans-serif</family>
        <prefer>
            <family>Noto Sans CJK SC</family>
        </prefer>
    </alias>
</fontconfig>

配置完成后，执行如下命令刷新系统字体缓存并校验配置是否生效：

# 刷新全局字体缓存
fc-cache -fv

# 校验黑体是否已强制映射为 Noto
fc-match "SimHei"
fc-match "黑体"

正常生效输出：字体字段显示 Noto Sans CJK SC ，不再匹配 SimHei。

4.2 适配 YUM 版 LibreOffice 的 XCU 私有配置

针对 YUM 安装的 LibreOffice 5.4 无全局 /opt 配置目录的问题，使用 root 用户私有配置目录（headless 模式默认以 root 运行，该配置永久生效），所有目录、文件均可直接复制执行。

1. 新建目录 + 字体替换规则配置：创建用户级 fontsubstitutes.xcu ，强制将 SimHei、黑体、微软雅黑等常见办公字体，全部映射为 Noto Sans CJK SC，覆盖 LibreOffice 内部字体匹配逻辑。

# 创建配置目录
mkdir -p /root/.config/libreoffice/4/user/config

# 写入字体替换规则
cat > /root/.config/libreoffice/4/user/config/fontsubstitutes.xcu << EOF
<?xml version="1.0" encoding="UTF-8"?>
<oor:component-data xmlns:oor="http://openoffice.org/2001/registry" oor:name="FontSubstitutes" oor:package="org.openoffice.Office">
  <node oor:name="FontSubstitutes">
    <prop oor:name="SimHei" oor:type="xs:string">
      <value>Noto Sans CJK SC</value>
    </prop>
    <prop oor:name="黑体" oor:type="xs:string">
      <value>Noto Sans CJK SC</value>
    </prop>
    <prop oor:name="Microsoft YaHei" oor:type="xs:string">
      <value>Noto Sans CJK SC</value>
    </prop>
    <prop oor:name="微软雅黑" oor:type="xs:string">
      <value>Noto Sans CJK SC</value>
    </prop>
  </node>
</oor:component-data>
EOF

2. 默认字体全局配置：创建 default_fonts.xcu ，指定 zh-CN 中文区域下，表格、文档、演示文稿的默认 CJK 字体为 Noto Sans CJK SC，确保新建、解析文档默认字体统一。

# 创建注册表配置目录
mkdir -p /root/.config/libreoffice/4/user/registry

# 写入默认 CJK 字体配置
cat > /root/.config/libreoffice/4/user/registry/default_fonts.xcu << EOF
<?xml version="1.0" encoding="UTF-8"?>
<oor:component-data xmlns:oor="http://openoffice.org/2001/registry" xmlns:xs="http://www.w3.org/2001/XMLSchema" oor:name="VCL" oor:package="org.openoffice">
  <node oor:name="DefaultFonts">
    <node oor:name="zh-CN">
      <prop oor:name="CJK_SPREADSHEET" oor:type="xs:string">
        <value>Noto Sans CJK SC</value>
      </prop>
      <prop oor:name="CJK_TEXT" oor:type="xs:string">
        <value>Noto Sans CJK SC</value>
      </prop>
      <prop oor:name="CJK_PRESENTATION" oor:type="xs:string">
        <value>Noto Sans CJK SC</value>
      </prop>
    </node>
  </node>
</oor:component-data>
EOF

4.3 缓存清理（关键必要步骤）

LibreOffice 会缓存旧字体规则，新配置不生效大多为缓存导致，本次排查固定清理命令，彻底清除历史缓存，执行如下完整清理命令，彻底清除 LibreOffice 缓存与临时文件，确保新字体配置无缓存干扰：

# 清理用户配置缓存
rm -rf /root/.config/libreoffice/cache

# 清理系统临时办公缓存
rm -rf /tmp/libreoffice*

4.4 PDF 转换命令参数兜底强化

在转换命令中增加字体嵌入、强制子集化参数，避免 PDF 渲染时 fallback 系统备用字体，保证导出文件字体固化，完整可直接上线的转换命令，包含全部兜底参数，适配线上批量转换场景：

# Excel 转 PDF 强制 Noto 字体、内嵌字体、子集化压缩
libreoffice --headless --norestore \
--convert-to pdf:"calc_pdf_Export:EmbedFonts=true;SubsetFonts=true;ForceSubsetFonts=true" \
--outdir /data/pdf_output /data/excel_source/test.xlsx

参数释义： EmbedFonts=true （PDF 内嵌字体，跨环境不丢失样式）、 SubsetFonts=true （仅嵌入使用字体，缩减 PDF 体积）、 ForceSubsetFonts=true （强制覆盖旧字体渲染规则）。

五、最终验证标准

安装 PDF 字体校验工具并执行检测，完整验证字体替换效果，达标方可上线：

# 安装字体查看工具
yum install poppler-utils -y

# 查看 PDF 所有内嵌字体
pdffonts /data/pdf_output/test.pdf

最终达标效果：PDF 字体列表中无 SimHei、黑体字体，仅存在 Noto Sans CJK SC，字体替换彻底生效，两台服务器导出字体样式完全统一。

六、问题核心总结

1. 服务器字体差异化问题根源不是字体未安装，而是 系统原有兜底字体存在与否 导致的渲染优先级差异；
2. LibreOffice 会优先适配文档标记字体+本地已有字体，系统默认字体配置无法覆盖文档内嵌字体规则；
3. 网络通用的 /opt 目录 XCU 配置不适用于 YUM 默认安装的 LibreOffice 环境，需使用用户私有配置目录；
4. 字体配置生效必须清理软件缓存，否则新规则永久不生效；
5. 单纯安装 Noto 字体无法解决存量文档黑体渲染问题，必须通过字体映射强制替换+内嵌字体双重兜底。