Flying Saucer 9.x生成PDF时印度语言显示异常求助

问题分析 #

卡纳达语、印地语这类印度语言属于复杂文字脚本，需要字体支持连字、字形重组等特性才能连贯显示。你的问题主要源于三个核心问题：

1. Java代码未将HTML内容加载到渲染器，导致字体配置与内容无关联；
2. 未针对不同语言指定专用优化字体；
3. CSS未启用复杂脚本渲染所需属性。

分步解决方案 #

1. 修复Java代码的核心错误 #

你的代码缺少加载HTML内容的关键步骤，同时优化字体加载逻辑，优先使用针对印度语言优化的开源字体（如Google Noto系列）：

public byte[] generatePdf(String processedHtml) throws Exception {
    ByteArrayOutputStream os = new ByteArrayOutputStream();
    try {
        ITextRenderer renderer = new ITextRenderer();
        
        // 加载语言专用字体（优先使用Noto系列，对复杂脚本支持更好）
        // 卡纳达语字体
        renderer.getFontResolver().addFont("/fonts/NotoSansKannada-Regular.ttf", BaseFont.IDENTITY_H, BaseFont.EMBEDDED);
        // 印地语（天城文）字体
        renderer.getFontResolver().addFont("/fonts/NotoSansDevanagari-Regular.ttf", BaseFont.IDENTITY_H, BaseFont.EMBEDDED);
        // 通用Unicode字体作为 fallback
        renderer.getFontResolver().addFont("/fonts/ArialUnicodeMS.ttf", "ArialUnicodeMS", BaseFont.IDENTITY_H, BaseFont.EMBEDDED, null);

        // 关键：将HTML内容加载到渲染器
        renderer.setDocumentFromString(processedHtml);
        
        renderer.layout();
        renderer.createPDF(os, false);
        renderer.finishPDF();
        return os.toByteArray();
    } catch (Exception e) {
        throw e;
    } finally {
        if (os != null) {
            try {
                os.close();
            } catch (IOException e) {
                // ignore
            }
        }
    }
}

2. 优化CSS配置，针对语言指定专用字体 #

修改HTML的CSS，为不同语言区块绑定对应字体，并启用复杂脚本渲染优化属性：

<html xmlns="http://www.w3.org/1999/xhtml">
    <head>
        <style type="text/css">
            .multiLang {
                font-size: 1.2em;
                text-rendering: optimizeLegibility; /* 启用字体连字优化 */
            }
            /* 卡纳达语专用样式 */
            .kannada {
                font-family: "Noto Sans Kannada", "ArialUnicodeMS", sans-serif;
            }
            /* 印地语专用样式 */
            .hindi {
                font-family: "Noto Sans Devanagari", "ArialUnicodeMS", sans-serif;
            }
        </style>
    </head>

    <body>
        <div class="multiLang">
            <h1>
                KA: <span class="kannada">ಸ್ವತಂತ್ರರಾಗಿ</span>, <br />
                HN: <span class="hindi">प्रत्येक व्यक्ति</span>
            </h1>
        </div>
    </body>
</html>

3. 字体文件准备 #

• 下载针对印度语言优化的Noto字体：
  • 卡纳达语：Noto Sans Kannada
  • 印地语：Noto Sans Devanagari
• 将字体文件放入项目的/fonts目录，确保路径与Java代码中的配置一致。

4. 额外优化（可选） #

如果仍有显示异常，可在加载HTML后添加以下配置，强制启用打印模式下的复杂脚本渲染：

// 在renderer.setDocumentFromString之后添加
renderer.getSharedContext().setPrint(true);
renderer.getSharedContext().setMediaType(MediaType.PRINT);

关键注意事项 #

• 复杂脚本语言必须使用支持字形重组的专用字体，通用字体（如Arial）无法正确处理印度语的连字规则；
• 嵌入字体时必须使用BaseFont.IDENTITY_H编码，确保支持完整Unicode字符集；
• 必须将HTML内容加载到渲染器，否则所有字体和CSS配置都无法生效。

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