Apache FOP生成PDF时Emoji显示异常（#号/空白）的解决求助

针对你遇到的Emoji显示为#或空白的问题，以下是经实践验证的解决步骤：

1. 修正字体配置（fop.xconf） #

Noto Color Emoji是内嵌SVG的OpenType字体，FOP对这类字体的加载需要明确配置，确保字体被正确识别和嵌入：

<fonts>
  <font kerning="yes" embed-url="./NotoColorEmoji-Regular.ttf" embedding-mode="subset">
    <font-triplet name="Noto Color Emoji" style="normal" weight="normal"/>
  </font>
  <!-- 保留你的其他字体配置 -->
</fonts>

• 开启FOP的DEBUG日志（在log4j配置中设置org.apache.fop.fonts为DEBUG），检查日志中是否有Loaded font相关条目，确认字体成功加载。
• 若加载失败，尝试使用字体文件的绝对路径，避免相对路径导致的加载问题。

2. 配置PDF版本与SVG支持 #

PDF 1.4及以下版本不支持SVG嵌入的彩色字体，必须将PDF版本设置为1.7+，并启用SVG嵌入：

<pdf>
  <version>1.7</version>
  <svg>
    <embedded>true</embedded>
  </svg>
</pdf>

此配置确保FOP生成的PDF能正确渲染SVG格式的Emoji图形。

3. 优化XSL-FO中的字体设置 #

在XSL-FO中明确指定Emoji的字体族，并确保回退逻辑：

<fo:block font-family="Noto Color Emoji, sans-serif" font-size="24pt">
  ♣ ✅ 🐐 😀
</fo:block>

• 对于由多个Unicode字符组成的Emoji（如带肤色修饰的表情），确保字符序列不被拆分，可将Emoji放在单独的fo:inline标签中。

4. 替代方案：兼容更广的单色Emoji #

如果彩色Emoji仍无法正常渲染，可改用Noto Emoji（非Color版本），这是普通TrueType字体，FOP支持更稳定，仅显示单色Emoji，但不会出现空白或#号问题。配置方式与上述一致，只需替换字体文件和font-triplet中的名称。

5. 版本升级与问题追踪 #

• FOP 2.4对SVG字体的支持有限，建议升级到最新稳定版（如2.9），新版本修复了多个与Emoji、SVG字体相关的Bug。
• 可查看FOP官方JIRA的相关条目（如FOP-2877），确认是否有针对特定Emoji渲染的补丁或解决方案。

内容的提问来源于stack exchange，提问作者SachinD