iText/PDFBox填PDF表单：马拉地语字段未点击异常，点击后恢复正常

这个问题的核心在于PDF表单字段的静态外观渲染和动态实时渲染机制差异，尤其是针对马拉地语这类需要复杂字形布局的非拉丁脚本语言。我来拆解具体原因：

1. PDF表单的两种显示逻辑 #

PDF表单字段存在两种渲染模式：

• 静态外观流（Appearance Stream）：当你用iText填充字段时，默认会生成一个预渲染的外观流，这是PDF阅读器打开文件时优先加载显示的内容。
• 动态实时渲染：当你点击字段进入编辑状态时，PDF阅读器会跳过预生成的外观流，直接使用字段的实际值+你嵌入的字体来实时渲染文本。

你的马拉地语内容点击后显示正常，说明字段的实际值和嵌入字体都是正确的，问题出在iText生成的静态外观流无法正确处理马拉地语的字形组合需求。

2. iText对复杂脚本的静态外观支持局限 #

马拉地语属于天城文体系，这类语言的显示需要特殊的字形布局处理：比如字符的连写、元音符号的叠加、字符顺序重排等。而从你的代码来看，你使用的应该是旧版iText 5，它的AcroFields组件在生成静态外观时，并没有针对这类复杂脚本做完整的字形布局适配——它能轻松处理英文这种左到右、无特殊字形组合的简单语言，但对马拉地语的复杂排版逻辑支持不足，导致生成的静态外观显示异常。

你代码里的字体设置是完全正确的（IDENTITY_H编码适配Unicode复杂脚本，FreeSans字体也支持马拉地语），所以动态渲染时阅读器能正确解析并显示文本。

3. 快速解决思路 #

如果你继续使用当前版本的iText，可以通过强制PDF阅读器始终使用动态渲染来规避这个问题：

String unicodeFontPath = "templates/font/FreeSans.ttf"; 
PdfReader reader = new PdfReader(src); 
PdfStamper filledOutForm = new PdfStamper(reader, new FileOutputStream(dest)); 
// 添加这一行，告诉阅读器忽略静态外观，实时渲染字段内容
filledOutForm.setNeedAppearances(true);
AcroFields fields = filledOutForm.getAcroFields(); 
BaseFont unicode = BaseFont.createFont(unicodeFontPath, BaseFont.IDENTITY_H, BaseFont.EMBEDDED); 
fields.setFieldProperty("Given Name Text Box", "textfont", unicode, null); 
fields.setField("Given Name Text Box", emp.getName());
// 记得关闭资源
filledOutForm.close();
reader.close();

如果要彻底解决静态外观的问题，建议升级到iText 7，它对复杂脚本的字形布局支持做了大幅优化，能正确生成马拉地语的静态外观流，无需依赖阅读器的动态渲染。

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