如何用Java的iText 7自动填充XFA PDF表单？

1. 严格匹配XML结构与XFA模板要求 #

XFA表单对XML数据的结构要求极高，必须完全匹配原表单的命名空间、节点层级、字段名称：

• 必须用填满所有字段的PDF生成完整XML模板，空PDF提取的不完整XML无法用于填充
• 检查修改后的XML节点路径是否与原模板完全一致，比如是否存在正确的<data>嵌套节点、命名空间前缀（如xfa:）是否正确

2. 移除追加模式（Append Mode） #

追加模式用于保留PDF签名，但XFA数据存储在PDF的特定字典中，追加模式下无法覆盖原有XFA数据，导致修改失效。若无需保留签名，直接移除该配置：

public void manipulatePdf2() throws IOException {
    PdfReader reader = new PdfReader(SRC);
    // 移除追加模式，允许覆盖原XFA数据
    PdfDocument pdfDoc = new PdfDocument(reader, new PdfWriter(DEST));
    PdfAcroForm form = PdfAcroForm.getAcroForm(pdfDoc, true);
    XfaForm xfa = form.getXfaForm();
    // 指定UTF-8编码读取XML，兼容瑞典语特殊字符
    xfa.fillXfaForm(new InputStreamReader(new FileInputStream(XML), StandardCharsets.UTF_8));
    xfa.write(pdfDoc);
    pdfDoc.close();
}

3. 处理编码兼容问题 #

瑞典语包含å、ä、ö等特殊字符，需确保：

• 修改后的XML文件以UTF-8编码保存（避免使用GBK等编码）
• 读取XML时明确指定UTF-8编码，使用InputStreamReader而非直接用FileInputStream

4. 验证XML有效性 #

用Adobe Acrobat打开原PDF，通过「工具>表单>更多表单选项>导入数据」导入你修改后的XML。若Adobe无法识别，说明XML结构或数据存在问题，需调整至Adobe可正常导入为止。

5. 确保iText版本为最新稳定版 #

旧版本iText 7可能存在XFA处理bug，建议使用最新稳定版，Maven依赖配置如下：

<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>itext7-core</artifactId>
    <version>7.2.8</version>
    <type>pom</type>
</dependency>

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