apache pdfbox 本身不支持直接为 acroform 表单字段设置文本下划线样式，但可通过在字段渲染位置手动绘制横线实现视觉等效效果；本文详解基于内容流（pdpagecontentstream）在签名后动态添加下划线的可靠方案。

apache pdfbox 本身不支持直接为 acroform 表单字段设置文本下划线样式，但可通过在字段渲染位置手动绘制横线实现视觉等效效果；本文详解基于内容流（pdpagecontentstream）在签名后动态添加下划线的可靠方案。

在使用 Apache PDFBox 填充并签署 PDF 表单后，若需对特定字段（如签名栏、姓名栏或金额栏）的文本添加下划线，需注意：PDFBox 的 PDTextField 不提供 setUnderline(true) 等原生 API，且 AcroForm 默认外观（DA 字符串）亦不支持下划线指令。因此，不能通过修改字段属性实现，而应采用“覆盖式绘图”策略——即在字段文本实际渲染位置下方，用 PDPageContentStream 绘制一条水平线。

✅ 推荐方案：在字段坐标处手动绘制下划线

关键步骤如下：

1. 获取字段所在页面及位置：通过 PDField.getWidget().getRectangle() 获取字段边界框（以 PDF 用户坐标系表示，原点在左下角）；
2. 计算下划线起止坐标：通常下划线位于文本基线（baseline）下方约 2–4 个单位处，宽度与字段宽度一致，Y 坐标需结合字体大小和行距调整；
3. 使用 PDPageContentStream 绘制横线：启用内容流，在精确坐标处调用 moveTo() → lineTo() → stroke()。

示例代码（适用于已签名、不可编辑的只读表单场景）：

Apache Superset Dashboard and SQL Exploration Skill

Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。

下载

PDPage page = ...; // 获取目标页面
PDTextField field = (PDTextField) acroForm.getField("fieldName");
PDAnnotationWidget widget = field.getWidgets().get(0);
PDRectangle rect = widget.getRectangle();
float x = rect.getLowerLeftX();
float y = rect.getLowerLeftY() + 5f; // 向上偏移约 5 单位，使线贴近文本底部（需根据字体大小微调）
float width = rect.getWidth();

try (PDPageContentStream contentStream = new PDPageContentStream(document, page, 
        PDPageContentStream.AppendMode.APPEND, true, true)) {

    // 设置线条样式（可选）
    contentStream.setLineWidth(0.8f);

    // 绘制下划线：从 (x, y) 到 (x + width, y)
    contentStream.moveTo(x, y);
    contentStream.lineTo(x + width, y);
    contentStream.stroke();
}

⚠️ 注意事项：

• 签名后限制：PDF 签名后若启用了“禁止内容修改”的签名策略（如 Certification 级别为 NO_CHANGE_ALLOWED），直接写入内容流将破坏签名有效性。务必确保签名类型为 APPROVAL 或允许注释/表单填充的 CERTIFIED_NO_CHANGE_ALLOWED；
• 坐标校准：PDRectangle 返回的是字段的边界框，但文本实际渲染区域可能略小（含内边距）。建议先用 field.getValue() 获取文本、估算字体高度（如 font.getFontDescriptor().getFontBoundingBox().getHeight() / 1000 * fontSize），再确定基线 Y 坐标；
• 多行字段处理：若字段支持多行，需按行拆分文本，逐行计算 Y 坐标并绘制对应下划线；
• 替代思路：若字段仍处于可编辑状态（未签名），可尝试自定义 DefaultAppearance（DA）字符串（如 /Helv 12 Tf 0 g），但 PDF 规范不支持 DA 中的下划线指令，故该方式无效——手动绘图是当前唯一稳定可行方案。

综上，虽然 PDFBox 未内置表单字段下划线功能，但通过精准坐标控制与底层内容流操作，完全可在签名后安全、可控地实现专业级下划线效果。建议将此逻辑封装为工具方法，传入字段名与偏移量参数，提升复用性与维护性。