使用HtmlConverter.convertToDocument转PDF时嵌入NotoColorEmoji.ttf失败求助

• 修正彩色字体加载方式：NotoColorEmoji是彩色OpenType字体，直接通过PdfFontFactory创建字体可能无法正确识别其彩色字形。改用FontProgramFactory直接加载字体程序，再添加到字体提供者：

  FontProgram notoEmojiFontProgram = FontProgramFactory.loadFont("/opt/NotoColorEmoji.ttf", true);
  fontProvider.addFont(notoEmojiFontProgram, PdfEncodings.IDENTITY_H);
  

• 确保HTML中指定表情字体：HTML内的表情符号元素需要明确指定使用NotoColorEmoji字体，否则iText会自动 fallback 到其他字体。比如给包含表情的文本或元素设置样式：

  .emoji { font-family: 'Noto Color Emoji', sans-serif; }
  

  或者在全局样式中设置字体 fallback 优先级，让NotoColorEmoji优先被选中处理表情。

• 验证字体文件有效性：确认/opt/NotoColorEmoji.ttf路径正确、文件未损坏，且该字体确实包含你需要显示的表情字形。可以用字体查看工具打开字体文件检查目标表情的存在性。

• 调整DefaultFontProvider的初始化参数：默认DefaultFontProvider会加载系统字体，可能导致表情被其他支持部分表情的字体拦截。尝试不加载默认字体，仅添加自定义字体和NotoColorEmoji：

  FontProvider fontProvider = new DefaultFontProvider(false, false, false);
  fontProvider.addDirectory(getCkEditorCustomFontsPath());
  // 再添加NotoColorEmoji字体程序
  

• 检查iText版本兼容性：iText对彩色字体的支持从7.1.x版本开始逐步完善，若使用的是更早版本，建议升级到7.1.15及以上版本，确保对CBDT/CBLC、COLR/CPAL等彩色字体格式的支持。

• 确认编码与字体匹配：虽然使用IDENTITY_H是正确的（支持全Unicode字符），但需确保HTML文档的编码为UTF-8，避免表情字符在转换前出现乱码。

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