使用Java iText7生成PDF时僧伽罗语文本渲染异常求助

核心问题排查点 #

• 字体编码设置错误：僧伽罗语属于Unicode复杂脚本，默认编码无法处理其连字、字形组合规则，需用支持字形映射的特殊编码。
• 可变字体加载适配不足：你使用的是可变轴字体（VariableFont），旧版iText7对这类字体的解析支持有缺陷，或加载方式未适配可变字体特性。
• 字体未嵌入PDF：仅引用字体而未嵌入，导致依赖目标设备的系统字体，若设备无对应字体则显示方框。
• 文本编码异常：Java字符串未以UTF-8正确存储或传递，导致字符损坏。

正确实现代码示例 #

import com.itextpdf.kernel.font.PdfFont;
import com.itextpdf.kernel.font.PdfFontFactory;
import com.itextpdf.kernel.pdf.PdfDocument;
import com.itextpdf.kernel.pdf.PdfWriter;
import com.itextpdf.layout.Document;
import com.itextpdf.layout.element.Paragraph;

import java.io.File;
import java.io.IOException;

public class SinhalaPdfGenerator {
    public static void main(String[] args) throws IOException {
        // 替换为你的字体文件实际路径
        String fontPath = "NotoSansSinhala-VariableFont_wdth,wght.ttf";
        
        // 加载字体：指定IDENTITY_H编码支持复杂脚本，强制嵌入字体
        PdfFont sinhalaFont = PdfFontFactory.createFont(
            fontPath,
            PdfEncodings.IDENTITY_H,
            PdfFontFactory.EmbeddingStrategy.FORCE_EMBEDDED
        );
        
        try (PdfWriter writer = new PdfWriter(new File("sinhala_output.pdf"));
             PdfDocument pdfDoc = new PdfDocument(writer);
             Document doc = new Document(pdfDoc)) {
            
            // 僧伽罗语文本示例
            String sinhalaText = "සිංහල අකුරු නිවැරදිව ප්‍රදර්ශනය කිරීම";
            
            Paragraph para = new Paragraph(sinhalaText)
                .setFont(sinhalaFont)
                .setFontSize(16);
            
            doc.add(para);
        }
    }
}

关键说明 #

1. 编码选择：必须使用PdfEncodings.IDENTITY_H，该编码专为Unicode复杂脚本设计，能处理僧伽罗语的字形组合规则，从根源避免乱码。
2. 强制嵌入字体：通过FORCE_EMBEDDED参数确保字体完整嵌入PDF，不依赖目标设备的系统字体，保证跨设备显示一致。
3. 版本要求：升级iText7到7.2.x及以上版本，旧版本对可变字体和复杂脚本的支持存在明显缺陷。

额外验证步骤 #

• 检查PDF字体属性：用Adobe Acrobat打开生成的PDF，查看「文件>属性>字体」，确认NotoSansSinhala字体已嵌入。
• 验证字体文件：用系统字体查看器打开字体文件，确认包含完整的僧伽罗语字形。
• 测试查看器：使用Adobe Acrobat或Chrome浏览器查看PDF，避免因轻量查看器不支持复杂脚本导致的显示异常。
• 确认文本编码：确保Java代码文件编码为UTF-8，读取外部文本时明确指定UTF-8编码。

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