PDF中日汉字渲染问题求助：含生僻字𣘺时内容全空白

核心原因 #

你当前配置的所有字体（ヒラギノ角ゴ、メイリオ、MS PGothic等）都不包含生僻字「𣘺」（Unicode编码U+2363A）的字形。部分HTML转PDF渲染引擎在遇到无法映射的字符时，会触发整段内容渲染失败的bug，而非仅显示占位符。

具体解决方案 #

1. 引入支持CJK生僻字的开源字体

选择覆盖扩展CJK汉字的字体，优先放在字体族列表最前面，确保渲染引擎优先加载能识别生僻字的字体：

div.alternative_name {
    font-family: 'Noto Sans CJK JP', 'ヒラギノ角ゴ Pro W3', 'Hiragino Kaku Gothic Pro', Osaka, 'メイリオ', Meiryo, 'ＭＳ Ｐゴシック', 'MS PGothic', sans-serif, 'Microsoft Yahei';
    font-size: 12px;
}

• 推荐字体：Noto Sans CJK JP（谷歌开源）、Source Han Sans（Adobe开源），二者均支持绝大部分CJK扩展区汉字
• 注意：必须将字体文件嵌入到PDF生成流程中，仅引用字体名称但未打包字体文件会导致无效。

2. 修复PDF渲染引擎的字符 fallback 逻辑

部分转PDF工具（如wkhtmltopdf、WeasyPrint）默认未开启字符 fallback，遇到缺失字符时直接中断渲染：

• 检查工具配置，启用「字体 fallback」功能（比如WeasyPrint需确保系统fontconfig正确配置）
• 开启「替代字符」选项，让引擎用□或其他占位符替代缺失字符，避免整段内容空白。

3. 单独为生僻字指定字体

如果生僻字出现频率低，可单独为其指定支持的字体，减少全局字体嵌入的体积：

<div class="alternative_name">
    辻󠄁直<span style="font-family: 'Noto Sans CJK JP';">𣘺</span>
</div>

4. 验证字符编码正确性

确认HTML文件编码为UTF-8，生僻字的实体编码𣘺对应正确的Unicode值U+2363A，避免编码错误导致的渲染异常。

快速验证方法 #

先在普通浏览器中打开包含「𣘺」的HTML页面：

• 若浏览器显示方块，说明是字体缺失问题，按方案1解决
• 若浏览器能正常显示，说明问题出在PDF工具的字体嵌入或渲染逻辑，按方案2排查。

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