使用Apache PDFBox API设置非英文字符时Windows端显示乱码的问题求助

Hi 👋，我仔细看了你的问题描述，这种跨平台的字体显示问题确实挺头疼的——明明在Mac上显示正常，Windows用Adobe Reader就乱码，还已经尝试嵌入字体却没生效，咱们一步步来排查解决：

首先先梳理下可能的问题根源：

• 字体嵌入时机不对，表单域本身的资源没正确关联到嵌入字体
• DefaultAppearance的格式或字体名称引用有偏差
• Windows下的Adobe Reader对嵌入字体的处理有特殊要求，比如需要完全嵌入而非子集嵌入

下面给你几个具体的修复方案，你可以逐个尝试：

方案一：确保字体完全嵌入并关联到表单域 #

PDFBox默认会子集嵌入字体，这可能导致Windows阅读器无法识别完整的非英文字符集。你可以在加载字体时禁用子集化：

// 加载字体时设置第三个参数为false，强制完全嵌入
unicodeFont = PDType0Font.load(document, stream, false);

除了设置表单的默认资源，还要单独给目标文本域绑定资源：

// 给文本域单独设置资源，避免继承原有文档的字体配置
PDResources fieldResources = textField.getResources();
if (fieldResources == null) {
    fieldResources = new PDResources();
    textField.setResources(fieldResources);
}
// 将嵌入字体添加到文本域的资源中
fieldResources.put(COSName.getPDFName(unicodeFont.getName()), unicodeFont);

方案二：修正DefaultAppearance的格式与编码设置 #

有时候字体名称的引用可能和实际嵌入的名称不匹配，建议先打印确认字体名称，再显式指定编码：

// 先确认嵌入字体的实际名称，避免拼写错误
String fontName = unicodeFont.getName();
System.out.println("嵌入字体名称：" + fontName);

// 修正DefaultAppearance，同时显式指定UTF-16编码（Type0字体适配非英文字符的标准编码）
textField.setDefaultAppearance(String.format("/%s 9 Tf 0.32 0.32 0.32 rg", fontName));
textField.setCOSString(COSName.ENCODING, COSName.getPDFName("UTF-16"));

方案三：清除表单域原有字体配置再重新绑定 #

有些表单域可能继承了文档原有字体设置，先清空再重新绑定嵌入字体：

// 移除文本域原有所有字体引用
if (textField.getResources() != null) {
    textField.getResources().getFontNames().forEach(textField.getResources()::remove);
}

// 重新添加嵌入字体到文本域资源
PDResources newResources = new PDResources();
newResources.put(COSName.getPDFName(unicodeFont.getName()), unicodeFont);
textField.setResources(newResources);

// 重新设置DefaultAppearance
textField.setDefaultAppearance(String.format("/%s 9 Tf 0.32 0.32 0.32 rg", unicodeFont.getName()));

额外验证与替代方案 #

1. 验证字体是否成功嵌入：用Adobe Reader打开生成的PDF，通过「文件>属性>字体」查看是否存在「Arial Unicode MS（嵌入）」，如果显示「嵌入子集」，说明还是子集嵌入，需要用方案一的完全嵌入方式。
2. 替换开源字体：Arial Unicode MS是商用字体，若授权有顾虑，可以换成开源的Unicode字体，比如Noto Sans CJK（支持中日韩）、Noto Sans Hebrew，只需要把字体文件替换成对应开源字体，代码逻辑完全一致，跨平台兼容性更好。

最后别忘了，设置完setValue后，一定要用document.save(outputStream)正确保存文档，并且确保所有流资源都通过try-with-resources正确关闭。

内容来源于stack exchange