在使用 PDFBox 填充 AcroForm 表单字段时，仅设置 PDAcroForm.setDefaultAppearance() 无法影响已有字段的显示颜色；必须为每个支持文本渲染的字段（如 PDVariableText）单独设置其 defaultAppearance，才能使字体颜色生效。
在使用 apache pdfbox 填充 acroform 表单字段时，仅设置 `pdacroform.setdefaultappearance()` 无法影响已有字段的显示颜色；必须为每个支持文本渲染的字段（如 `pdvariabletext`）单独设置其 `defaultappearance`，才能使字体颜色生效。
PDFBox 的表单字段颜色控制机制具有层级性：PDAcroForm.setDefaultAppearance() 仅作为全局默认值，用于新创建的字段或未显式配置外观的字段；而已存在的可编辑文本字段（如 PDTextField）通常继承自 PDVariableText，其实际渲染行为由字段自身的 defaultAppearance 字符串决定，而非表单级设置。
因此，若要为特定字段（如患者 ID、诊断结果等）设置白色文本（RGB 1,1,1），需在调用 field.setValue(...) 前，强制为其指定外观字符串：
PDField field = pDAcroForm.getField(fieldID);
if (field instanceof PDVariableText) {
// 关键修复：为每个文本字段单独设置 defaultAppearance
((PDVariableText) field).setDefaultAppearance("/Helv 0 Tf 1 1 1 rg"); // 白色（RGB）
field.setValue(replacementText);
} else {
// 非文本字段（如复选框、下拉列表）无需设置颜色，跳过或按需处理
field.setValue(replacementText);
}
⚠️ 注意事项：
Apache 2.4.62
下载
PHP中文网提供Apache 2.4.62 官方 tar.gz 源码包下载，通过源码编译安装，开发者能够灵活定制模块、优化性能并精准控制安装路径，满足多样化的业务需求。
- /Helv 0 Tf 中的 0 表示自动缩放字体大小以适配字段区域，这是 PDF 规范推荐做法；若需固定字号（如 12），可改为 /Helv 12 Tf。
- 颜色操作符必须匹配色彩空间：
- g 用于灰度（0 g = 黑，1 g = 白）；
- rg 用于 RGB（1 1 1 rg = 白，0 0 0 rg = 黑）；
- k 用于 CMYK（不推荐用于屏幕显示场景）。
- PDType1Font.TIMES_ROMAN 已注册为 /Helv 别名，因此资源映射 resources.put(COSName.HELV, font) 是必要前提，否则 /Helv 将解析失败。
- 若字段类型为 PDTextField 但未继承 PDVariableText（极少见），建议用 instanceof PDTextField 作兜底判断，并通过反射或调试确认其实际类名。
✅ 正确实践总结：
- 保留 pDAcroForm.setDefaultResources(resources) 注册字体；
- 移除或保留 pDAcroForm.setDefaultAppearance(...)（仅作后备）；
- 对每个 PDVariableText 实例调用 setDefaultAppearance(...)；
- 再执行 field.setValue(...) —— 此时颜色将立即生效。
该方案兼容 PDFBox 2.x 全系列（包括 v2.0.27），无需升级依赖，且不影响字段布局、交互行为或导出兼容性。
