使用iTextPDF转换含输入框HTML为PDF时遇空白页及页码问题

问题1：convertToDocument生成空白页面 #

空白页通常源于文档初始化/关闭流程错误、baseUri配置失效，或HTML内容解析异常，按以下步骤修正：

• 确保PdfDocument与PdfWriter初始化完整，转换完成后手动关闭文档
• 验证baseUri指向HTML文件所在目录，避免资源加载失败
• 确认HTML内容无语法错误，输入元素格式符合标准（如<input type="text">）

示例代码：

File htmlSource = new File("input.html");
File pdfDest = new File("output.pdf");

// 初始化PDF写入器与文档
PdfWriter writer = new PdfWriter(pdfDest);
PdfDocument pdfDocument = new PdfDocument(writer);
pdfDocument.setDefaultPageSize(PageSize.A4);

// 配置转换属性
ConverterProperties converterProperties = new ConverterProperties();
converterProperties.setBaseUri(htmlSource.getParent()); // 指向HTML所在目录
converterProperties.setCreateAcroForm(true); // 启用可填写表单生成

// 执行HTML转PDF文档
HtmlConverter.convertToDocument(new FileInputStream(htmlSource), pdfDocument, converterProperties);

// 添加页码逻辑（见下方）
addPageNumbers(pdfDocument);

// 必须关闭文档确保内容写入
pdfDocument.close();

问题2：convertToPdf调用footerHandler.writeTotal报空指针 #

空指针是因为convertToPdf会直接完成文档写入并关闭，此时文档对象已被释放，无法再操作页码。正确做法是在文档打开状态下添加页码：

• 放弃convertToPdf静态方法，改用convertToDocument配合手动文档管理
• 自定义页码添加逻辑，避免依赖未适配可填写表单的示例footerHandler

自定义页码示例：

private static void addPageNumbers(PdfDocument pdfDocument) {
    int totalPages = pdfDocument.getNumberOfPages();
    PdfFont font = PdfFontFactory.createFont(StandardFonts.HELVETICA);
    
    for (int i = 1; i <= totalPages; i++) {
        PdfPage page = pdfDocument.getPage(i);
        PdfCanvas canvas = new PdfCanvas(page.newContentStreamBefore(), page.getResources(), pdfDocument);
        canvas.beginText()
                .setFontAndSize(font, 10)
                .moveText(page.getPageSize().getWidth() / 2 - 25, 20)
                .showText(String.format("第 %d 页 / 共 %d 页", i, totalPages))
                .endText();
    }
}

关键注意事项 #

• iText 5.0.5版本中，setCreateAcroForm(true)仅与convertToDocument兼容，必须手动关闭文档才能确保表单内容写入
• 页码添加必须在文档未关闭时执行，避免操作已释放的资源
• 若HTML包含CSS样式，需确保样式规则不干扰表单元素渲染

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