iText 7 PdfTextFormField setValue方法部分字符显示异常问题

该异常和字体本身的字符支持能力无关，核心原因有两点：

1. iText7的com.itextpdf.forms.fields.PdfFormField#setValue(String)单参数重载，默认使用单字节WinAnsi编码生成表单字段的外观流（也就是用户看到的显示内容），该编码仅覆盖Latin-1扩展区的字符。你传入的字符串中，前半段ßěščřžýáíé刚好在WinAnsi编码映射范围内，末尾的♠♥︎♦♣Ś5个字符超出编码范围，iText生成外观时会直接丢弃无法编码的字符，因此显示内容截断；但字段的实际值是作为Unicode字符串存在PDF的字段值条目里的，所以读取字段值时能拿到完整内容。
2. 你提到的Helvetica是PDF规范定义的14种内置标准Type1字体之一，本身是单字节编码字体，没有特殊符号和非Latin扩展字符的字形映射。你在Acrobat中手动输入时显示正常，是Acrobat做了自动字体fallback替换，不是内置Helvetica本身支持这些字符，iText生成PDF时不会做这类自动兜底替换。

不要使用仅传字符串值的setValue单参数重载，显式指定嵌入的Unicode字体生成字段外观，操作步骤如下：

• 加载支持所有目标字符的TrueType/OpenType字体，使用IDENTITY_H（Unicode水平书写）编码，强制嵌入字体到PDF中，代码示例：

// 替换为本地实际的支持目标字符集的Unicode字体路径，如Arial Unicode MS、思源黑体等
PdfFont unicodeFont = PdfFontFactory.createFont(
    "本地字体文件绝对路径",
    PdfEncodings.IDENTITY_H,
    PdfFontFactory.EmbeddingStrategy.PREFER_EMBEDDED
);

• 调用三参数重载的setValue方法，传入目标值、加载好的Unicode字体、对应字号，给字段赋值：

PdfFormField targetField = acroForm.getField("First Name");
// 传入值、字体、字号
targetField.setValue("ßěščřžýáíé♠♥︎♦♣Ś", unicodeFont, 12f);

• 如果字段存在旧的外观缓存，赋值后调用targetField.regenerateField()强制重绘字段外观，确保新的外观流生效。

注意：所有需要存储非Latin-1范围字符的PDF表单字段，都不要依赖PDF内置的14种标准Type1字体（包括Helvetica、Times Roman、Courier系列），这类字体没有强制要求提供Unicode映射表，跨工具渲染时必然出现编码截断、乱码问题，必须显式嵌入覆盖目标字符集的Unicode字体。

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