PDF AcroFields手机号填充异常：含ISD码时长度计算错误

问题背景 #

使用iText填充PDF表单时，手机号字段仅显示部分内容（如+91-961744），完整手机号+91-9617447617无法全部显示，原因是字段将ISD码及符号计入长度限制。基础操作代码如下：

bos = new ByteArrayOutputStream();
blankStatutoryFormsFolder = CommonUtil.getLocalPath() + environment.getProperty("Blank_Statutory_Forms");

reader = new PdfReader(blankStatutoryFormsFolder + "FORM_11.pdf");
stamper = new PdfStamper(reader, bos, '\0', true);
acroFields = stamper.getAcroFields();

填充字段的代码：

if (employeeResponse.getMobileNo() != null) {
    acroFields.setField("topmostSubform[0].Page1[0].mobile_no[0]", employeeResponse.getMobileNo());
}

解决方案 #

1. 修改字段最大长度限制 #

直接修改PDF字段的MaxLen属性，让它能容纳完整的手机号内容：

if (employeeResponse.getMobileNo() != null) {
    String fieldName = "topmostSubform[0].Page1[0].mobile_no[0]";
    // 获取字段合并后的PDF字典
    PdfDictionary fieldDict = acroFields.getFieldItem(fieldName).getMerged(0);
    // 设置最大长度为15（适配+91-10位手机号的总长度）
    fieldDict.put(PdfName.MaxLen, new PdfNumber(15));
    // 填充字段值
    acroFields.setField(fieldName, employeeResponse.getMobileNo());
}

2. 移除字段的验证脚本（若存在） #

部分表单字段会通过JavaScript脚本限制输入长度，可直接清除这类验证逻辑：

String fieldName = "topmostSubform[0].Page1[0].mobile_no[0]";
PdfDictionary fieldDict = acroFields.getFieldItem(fieldName).getMerged(0);
// 移除字段的动作脚本（包含验证逻辑）
fieldDict.remove(PdfName.AA);
// 填充字段值
acroFields.setField(fieldName, employeeResponse.getMobileNo());

3. 强制重新生成字段外观 #

如果修改长度后仍显示异常，可强制重新生成字段外观，确保内容正确渲染：

if (employeeResponse.getMobileNo() != null) {
    String fieldName = "topmostSubform[0].Page1[0].mobile_no[0]";
    // 调整字段最大长度
    PdfDictionary fieldDict = acroFields.getFieldItem(fieldName).getMerged(0);
    fieldDict.put(PdfName.MaxLen, new PdfNumber(15));
    // 填充字段并重新生成外观
    acroFields.setField(fieldName, employeeResponse.getMobileNo());
    acroFields.regenerateField(fieldName);
}

注意事项 #

• 上述代码基于iText 5.x版本编写，若使用iText 7.x需调整对应API（如PdfAcroForm替代AcroFields）
• 可根据实际手机号格式调整MaxLen的数值，确保覆盖完整内容

内容的提问来源于stack exchange，提问作者Bindu Kumari