如何解决Apache PDFBox生成的XFA结构PDF无法在Android读取的问题？

我之前也碰到过一模一样的坑——用PDFBox生成带XFA结构的PDF在桌面端正常，但到Android上就弹出那个“Please wait... If this message is not eventually replaced by the proper contents of the document, your PDF viewer may not be able to display this type of document”的错误提示。折腾了好几个方案，下面是实践下来有效的思路：

先搞懂核心原因 #

Android系统自带的PDF查看器（比如Google PDF Viewer）以及绝大多数第三方PDF应用，对**XFA（XML Forms Architecture）**的支持非常有限，甚至完全不支持。XFA是Adobe主导的表单技术，主要在桌面端Acrobat系列软件里适配，移动端基本没做兼容，这才是问题的根源。

可行解决方案 #

1. 放弃XFA，改用标准AcroForm表单 #

这是最稳妥的方案，因为AcroForm是PDF的标准表单格式，Android所有主流PDF查看器都支持。用PDFBox生成AcroForm的示例代码大概是这样：

PDDocument document = new PDDocument();
PDPage page = new PDPage();
document.addPage(page);

// 创建标准AcroForm
PDAcroForm acroForm = new PDAcroForm(document);
document.getDocumentCatalog().setAcroForm(acroForm);

// 添加文本字段示例
PDTextField textField = new PDTextField(acroForm);
textField.setPartialName("sampleField");
acroForm.getFields().add(textField);

// 把字段添加到页面上
PDAnnotationWidget widget = textField.getWidgets().get(0);
PDRectangle rect = new PDRectangle(50, 700, 200, 30);
widget.setRectangle(rect);
page.getAnnotations().add(widget);

document.save("standard-form.pdf");
document.close();

这样生成的PDF完全是标准格式，Android端打开毫无问题。

2. 把XFA PDF扁平化（转为静态内容） #

如果因为业务原因必须生成XFA表单，那可以用PDFBox自带的工具把XFA内容渲染成静态PDF，去掉XFA结构。这样虽然表单失去了交互性，但至少能在Android上正常显示：

PDDocument document = PDDocument.load(new File("xfa-form.pdf"));
PDFXfaFormConverter converter = new PDFXfaFormConverter();
// 转换后XFA会被替换成静态内容
converter.convert(document);
document.save("flattened-form.pdf");
document.close();

注意这个转换需要PDFBox的完整依赖，确保你的项目里包含了所有相关模块。

3. 换用Android兼容更好的PDF生成库 #

如果需要保留表单交互性，且XFA是刚需，可以考虑切换到iText 7（注意商用授权问题，非开源项目需要付费）。它对AcroForm的支持更完善，生成的表单在Android端兼容性极佳；如果一定要用XFA，iText也提供了更友好的转换工具，能生成Android可识别的兼容版本。

另外，如果你只需要生成简单的PDF，也可以试试Android原生的PdfDocument类，虽然功能有限胜在原生适配完美。

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