我来帮你搞定这个iText 5设置PDF表单字体的坑！你遇到的ClassCastException其实原因很直白：form.setFieldProperty()方法的第三个参数需要传入实际的Font对象，而不是字体名称的字符串。你代码里错误传了"Helvetica"字符串，这就触发了类型转换错误。

正确的实现代码 #

// 获取带编码和嵌入属性的Helvetica字体对象
Font helvetica = FontFactory.getFont(FontFactory.HELVETICA, BaseFont.IDENTITY_H, BaseFont.EMBEDDED);
// 获取表单对象
AcroFields form = stamper.getAcroFields();
// 为目标字段设置字体（这里传入的是Font对象，不是字符串！）
form.setFieldProperty("Text Field 1", "textfont", helvetica, null);
// 可选：如果需要调整字体大小，可额外添加这行
form.setFieldProperty("Text Field 1", "textsize", new Float(12), null);

关键细节要注意 #

• 必须用Font实例作为setFieldProperty的第三个参数，绝对不能传字符串！这是你报错的核心原因。
• 建议指定字体编码（比如BaseFont.IDENTITY_H支持全Unicode字符）和嵌入字体（BaseFont.EMBEDDED），避免目标机器没有Helvetica字体时出现显示乱码或字体替换的问题。
• 要确保字段名称"Text Field 1"和PDF里实际的表单字段名称完全一致，这个是大小写敏感的。

复盘你的错误代码 #

你原来的代码：

Font Helvetica = FontFactory.getFont("Helvetica");
form.setFieldProperty("Text Field 1", "textfont", "Helvetica", null);

这里虽然正确获取了Font对象，但调用setFieldProperty时却传了字符串"Helvetica"，而方法期望的是Font类型，JVM尝试把字符串强制转成Font时自然就抛出ClassCastException了。

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