辣目洋子1. 问题背景与场景还原
最近在做一个政务系统对接项目时，遇到一个典型的PDF表单填报需求。使用Apache PdfBox库处理动态表单填充时，发现当表单字段填入较长文本内容时，系统自动换行后的行间距明显过大，导致整体排版异常。这种问题在合同、申请表等正式文档生成场景中尤为突出——文字间距过大不仅影响美观，还可能被误认为故意留白修改区域。
具体表现是：当我们在多行文本域（如地址、备注等字段）输入超过显示宽度的内容时，PdfBox的自动换行功能会以约1.5倍行距的间距分隔文本行。而实际业务中，文档规范通常要求保持与原文一致的行距（多为1倍或1.2倍）。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心问题诊断
2.1 PdfBox文本处理机制
通过调试PdfBox源码发现，其表单文本渲染主要依赖PDTextField的setValue方法。在处理多行文本时，关键参数包括：
- 字体度量（FontMetrics）
- 行高（Leading）
- 字符间距（Character Spacing）
- 字间距（Word Spacing）
问题根源在于PdfBox默认使用字体高度的1.5倍作为行距（Leading），这个设计本意是确保可读性，但在中文表单场景下反而造成排版失调。
2.2 间距计算原理
行距计算公式为：
code复制实际行距 = 字体高度 × 行距系数 + 额外间距
其中：
- 中文字体（如SimSun）高度通常为字体大小的1.2倍
- PdfBox默认行距系数为1.5
- 额外间距包含基线偏移等参数
例如使用12pt字体时：
code复制字体高度 = 12 × 1.2 = 14.4pt
默认行距 = 14.4 × 1.5 = 21.6pt
这导致行间距达到7.2pt（21.6-14.4），远大于常规文档的3-5pt间距。
3. 解决方案实现
3.1 直接修改行距参数
最直接的解决方案是重写文本绘制逻辑，通过PDTextFormatter调整行距：
java复制PDTextField textField = (PDTextField) acroForm.getField(fieldName);
textField.setValue(textValue);
// 关键修改点
PDTextFormatter textForm