Flying Saucer生成PDF时页脚阿拉伯文本定位异常

问题背景 #

长期使用Flying Saucer生成带重复页眉页脚的PDF，原有功能正常。为支持阿拉伯文本，已嵌入Noto Sans Arabic字体并实现RTLTextReplacedElementFactory，正文阿拉伯文本显示正常，但页脚中的阿拉伯文本出现定位错误，该问题在iText5和OpenPDF中均可复现。

当前页脚使用的CSS如下：

@page {
    @bottom-left {
        content: element(footer);
        vertical-align: top;
        border-top: 1px solid black;
    }

    size: A4 portrait;
    margin: 2cm;
}

html,
body {
    font-family: 'Roboto', sans-serif;
    font-size: 12pt;
}

.arabic {
    font-family: "Noto Sans Arabic", sans-serif;
    font-size: 10pt;
    font-style: normal;
    font-weight: 100;
}

div#footer {
    display: block;
    position: running(footer);
}

可能原因 #

1. Flying Saucer对running类型元素（页脚）的RTL文本布局逻辑与正文不同，未正确处理RTL方向的文本对齐和定位
2. @bottom-left区域的默认布局方向与阿拉伯文本的RTL自然方向冲突，导致文本偏移

调试与解决步骤 #

1. 强制设置RTL方向与对齐 #

给阿拉伯文本类和页脚容器显式添加RTL方向属性，确保文本布局逻辑生效：

.arabic {
    font-family: "Noto Sans Arabic", sans-serif;
    font-size: 10pt;
    font-style: normal;
    font-weight: 100;
    direction: rtl;
    text-align: right;
}

div#footer {
    display: block;
    position: running(footer);
    direction: rtl;
    width: 100%;
}

/* 同时给页脚区域添加RTL方向 */
@page {
    @bottom-left {
        content: element(footer);
        vertical-align: top;
        border-top: 1px solid black;
        direction: rtl;
    }

    size: A4 portrait;
    margin: 2cm;
}

2. 检查RTLTextReplacedElementFactory实现 #

确认自定义的RTLTextReplacedElementFactory是否对running元素的文本做了正确处理。部分实现可能仅针对正文元素，需确保所有文本节点（包括页脚）都经过RTL转换。

3. 尝试替代页脚实现方式 #

如果running元素的RTL问题无法通过CSS解决，可尝试用绝对定位模拟页脚：

div#footer {
    position: absolute;
    bottom: 2cm; /* 对应@page的margin值 */
    left: 2cm;
    right: 2cm;
    border-top: 1px solid black;
    direction: rtl;
}

注意这种方式需要确保每页都生成页脚，可能需要配合Flying Saucer的分页逻辑调整。

4. 升级Flying Saucer版本 #

检查Flying Saucer的最新版本，确认是否有修复running元素RTL布局的相关补丁，部分旧版本存在此类兼容性问题。

5. 验证字体完整性 #

确认Noto Sans Arabic字体已完整嵌入PDF，字体缺失或不完整可能导致文本渲染异常，进而影响定位。

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