使用iText PDF 7生成PDF时泰米尔文字符错乱问题求助

问题分析 #

你遇到的泰米尔文字符错乱（预期வழங்கப்பட்ட தேதி，实际输出வழங்கப்பட்ட ததி），核心原因是泰米尔文属于复杂书写系统，需要专门的排版引擎处理字形组合规则，而iText核心模块默认不支持这类复杂脚本的渲染，必须依赖itext-typography扩展模块。

解决方案 #

1. 引入必要依赖 #

确保项目中添加itext-typography依赖（版本需与iText 7核心版本匹配），以Maven为例：

<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>itext-typography</artifactId>
    <version>7.2.5</version> <!-- 替换为你使用的iText 7版本 -->
</dependency>

2. 修正代码细节 #

以下是调整后的代码，解决路径转义、字体加载和复杂脚本渲染问题：

public static final String TAMIL_TEXT = "வழங்கப்பட்ட தேதி -- கொடுக்கப்பட்ட தேதி";

protected String generateTamilPDF(String dest) throws Exception {
    PdfDocument pdfDoc = new PdfDocument(new PdfWriter(dest));
    Document doc = new Document(pdfDoc, PageSize.A4);
    
    // 注意Windows路径需用双反斜杠转义，或改用正斜杠
    PdfFont tamilFont = PdfFontFactory.createFont(
        "C:\\Users\\xxx\\Downloads\\noto-sans-tamil\\NotoSansTamilRegular.ttf",
        PdfEncodings.IDENTITY_H
    );
    
    Paragraph p = new Paragraph("This is auto detection: ");
    Text tamilText = new Text(TAMIL_TEXT).setFont(tamilFont);
    
    // 启用复杂脚本排版处理，确保泰米尔文字形正确组合
    Typography.applyFontStyles(tamilText);
    
    p.add(tamilText);
    p.add(new Text(": 50.00 USD"));
    
    doc.add(p);
    doc.close();
    return dest;
}

3. 关键注意事项 #

• 路径转义：Windows系统中文件路径的反斜杠\必须转义为\\，否则会被识别为转义字符，导致字体文件加载失败。
• 字体验证：确认NotoSansTamilRegular.ttf文件完整且支持泰米尔文的所有字形（Noto Sans Tamil是Google专门为泰米尔文设计的字体，通常没问题）。
• 版本兼容：itext-typography的版本必须与iText 7核心版本一致，避免因版本不兼容导致的渲染异常。

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