PDF模板必须是XFA或AcroForm格式才能用XML填充，普通PDF不支持；AcroForm为当前主流，XFA已逐步淘汰；字段名须与XML节点名严格一致（含大小写及嵌套扁平化），且需校验XML结构。
PDF模板必须是XFA或AcroForm格式才能用XML填充
普通PDF无法直接用XML数据填充，只有两种PDF支持XML数据绑定：Adobe的XFA表单（已逐步淘汰但仍有遗留系统在用）和标准AcroForm表单（带命名字段）。如果你手里的PDF是“导出为PDF”的Word生成物、截图转PDF或纯版式PDF，xml根本不会被识别——工具会静默失败或报Field not found类错误。
验证方法：用Adobe Acrobat打开PDF → 右键任意表单域 → “属性” → 查看“常规”页签中的“字段名称”是否非空；或用pdfinfo -f 1 your.pdf（Linux/macOS）检查是否含Form: AcroForm字样。
Java推荐iText7 + xmlworker（仅限AcroForm）
iText7本身不解析XML，需配合xmlworker或手动映射字段。更稳妥的做法是用PdfAcroForm加载XML后逐字段赋值。注意：iText7.2+已移除对XFA的支持，只处理AcroForm。
- 确保PDF字段名与XML节点名严格一致（区分大小写），例如XML中
INV-2024-001，PDF字段名也必须是invoice_no - 嵌套XML（如
Alice）需扁平化字段名，如PDF字段应为customer.name或customer_name（取决于你解析逻辑） - 日期/数字字段需提前格式化为PDF字段接受的字符串，比如
date字段填"2024-05-20"而非"2024-05-20T00:00:00Z"
PdfDocument pdfDoc = new PdfDocument(new PdfReader("template.pdf"), new PdfWriter("filled.pdf"));
PdfAcroForm form = PdfAcroForm.getAcroForm(pdfDoc, true);
Document xmlDoc = Jsoup.parse(new File("data.xml"), "UTF-8");
Elements fields = xmlDoc.select("*");
for (Element e : fields) {
String name = e.tagName();
String value = e.text();
if (form.getField(name) != null) {
form.getField(name).setValue(value);
}
}
pdfDoc.close();
Python用pypdf + lxml（轻量、无依赖、仅AcroForm）
pypdf（v3.0+）可读写AcroForm字段，不依赖Java环境，比reportlab或weasyprint更适合已有PDF模板的场景。XML解析用lxml.etree最稳，避免xml.etree.ElementTree对命名空间或编码的隐式处理出错。
立即学习“Java免费学习笔记（深入）”；
