Java PDF加页码报错 "font and size must be set before writing any text" 解析

引言

在日常的开发中，我们经常会使用Java来进行PDF文件的生成和处理。然而，有时候我们在为PDF文档添加页码时，可能会遇到一个常见的错误信息："font and size must be set before writing any text"。这个错误通常发生在我们尝试在PDF文档中写入文本之前设置字体和字号的时候。本文将详细解析这个错误的原因以及如何避免它的发生。

问题分析

在开始解析问题之前，我们先了解一下PDF文档的基本结构。PDF（Portable Document Format）是一种用于呈现和交换文档的文件格式。它由Adobe Systems开发，旨在保持文档的格式化和布局在不同设备和操作系统上的一致性。

要理解为什么会发生 "font and size must be set before writing any text" 错误，我们需要了解PDF文档的创建过程。在Java中，我们通常使用一些开源库（如iText或Apache PDFBox）来生成和处理PDF文档。

在创建PDF文档时，我们需要先创建一个PDF文档对象，然后在该文档上进行各种操作，例如添加文本、图片、表格等等。在添加文本之前，我们需要设置字体和字号，以确保文本以正确的格式呈现。

代码示例

以下是一个使用iText库来生成PDF文档并添加页码的Java代码示例：

import com.itextpdf.text.Document;
import com.itextpdf.text.DocumentException;
import com.itextpdf.text.Font;
import com.itextpdf.text.pdf.BaseFont;
import com.itextpdf.text.pdf.PdfWriter;

import java.io.FileNotFoundException;
import java.io.FileOutputStream;

public class PDFPageNumberExample {

    public static void main(String[] args) {
        Document document = new Document();

        try {
            PdfWriter writer = PdfWriter.getInstance(document, new FileOutputStream("output.pdf"));
            document.open();

            // 设置字体和字号
            BaseFont baseFont = BaseFont.createFont("Arial.ttf", BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);
            Font font = new Font(baseFont, 12);

            // 添加文本
            document.add(new Paragraph("Hello, World!", font));

            // 添加页码
            int pageCount = writer.getPageNumber();
            for (int i = 1; i <= pageCount; i++) {
                document.showTextAligned(new Phrase(String.format("Page %d of %d", i, pageCount), font), 400, 30, i, Element.ALIGN_CENTER, 0);
            }

            document.close();
        } catch (DocumentException | FileNotFoundException e) {
            e.printStackTrace();
        }
    }
}

在上面的示例代码中，我们首先创建了一个Document对象，然后使用PdfWriter类将其与输出文件关联起来。在打开文档之后，我们设置了字体和字号，并添加了一段文本。然后，我们获取总页数，并使用showTextAligned方法在每一页的指定位置添加页码。

然而，当我们运行这段代码时，我们将会遇到 "font and size must be set before writing any text" 错误。接下来，我们将详细解释为什么会发生这个错误以及如何解决它。

错误原因

这个错误的原因在于我们在尝试添加文本之前没有设置字体和字号。在iText库中，当我们尝试在PDF文档中写入文本时，我们必须首先设置字体和字号，以确保文本能够正确地显示。

在上面的示例代码中，我们在添加文本之前确实设置了字体和字号，但是我们没有将字体和字号传递给document对象。

解决方法

要解决 "font and size must be set before writing any text" 错误，我们需要在添加文本之前将字体和字号设置到document对象中。修改示例代码如下：

import com.itextpdf.text.Document;
import com.itextpdf.text.DocumentException;
import com.itextpdf.text.Font;
import com.itextpdf.text.Paragraph;
import com.itextpdf.text.pdf.BaseFont;
import com.itextpdf.text.pdf.PdfWriter;

import java.io.FileNotFoundException;
import java.io.FileOutputStream;
import java.io.IOException;

public class