如何使用PDFBox生成包含格式化JSON内容的PDF文件

现有代码无法输出规范格式化JSON，核心是三个逻辑缺失：

• 未给不同层级的JSON内容添加对应缩进空格
• 直接遍历JSONObject时，数组、嵌套对象类型的值会被转为单行字符串，不会自动拆分换行
• 未处理键值对末尾的逗号、闭合括号的缩进对齐逻辑

不需要手动写递归处理JSON结构，直接借助JSON库自带的格式化能力，先将JSON序列化为带固定缩进的标准格式化字符串，再逐行写入PDF即可，实现成本最低且格式完全符合通用JSON排版规范。

核心逻辑 #

1. 调用JSON库的格式化序列化方法，直接生成带2空格缩进的带换行JSON字符串
2. 将格式化字符串按换行符拆分为单行数组，逐行写入PDF，每写完一行调用newLine()换行

如果你使用FastJSON，格式化JSON的代码为：

String formattedJson = JSON.toJSONString(jsonObject, SerializerFeature.PrettyFormat);

如果你使用Jackson，替换为如下代码即可：

ObjectMapper mapper = new ObjectMapper();
String formattedJson = mapper.writerWithDefaultPrettyPrinter().writeValueAsString(jsonObject);

完整可运行代码 #

public void testPDF() throws IOException {
    String json = "{\"appId\":\"wxa033f083bd79132d\",\"timestamp\":1657699905,\"nonceStr\":\"SKIe2Ce352\",\"signature\":\"20fbc391ed6ed78a3a267c31526239110926a8d1\",\"jsApiList\":[\"updateAppMessageShareData\",\"updateTimelineShareData\"]}";
    JSONObject jsonObject = JSON.parseObject(json);
    // 生成带标准缩进的格式化JSON字符串
    String formattedJson = JSON.toJSONString(jsonObject, SerializerFeature.PrettyFormat);

    // 用try-with-resources自动关闭资源，避免泄漏
    try (PDDocument document = new PDDocument()) {
        PDPage pdPage = new PDPage();
        document.addPage(pdPage);
        try (PDPageContentStream contentStream = new PDPageContentStream(document, pdPage)) {
            contentStream.beginText();
            // 含中文请替换为PDType0Font加载本地TTF中文字体，内置PDType1Font不支持中文
            contentStream.setFont(PDType1Font.HELVETICA, 12);
            // 设置写入起始坐标，A4页面高度约为842单位，Y值越小位置越靠下
            contentStream.newLineAtOffset(25, 750);
            contentStream.setLeading(18f); // 行间距设为字体大小的1.5倍，避免内容重叠

            // 拆分逐行写入
            String[] lines = formattedJson.split(System.lineSeparator());
            for (String line : lines) {
                contentStream.showText(line);
                contentStream.newLine();
            }

            contentStream.endText();
        }
        document.save(new File("D:\\new-doc-text.pdf"));
    }
}

• 若JSON包含中文字符，禁止使用PDFBox内置的PDType1Font字体，这类字体不支持中文编码，需要通过PDType0Font加载本地TTF格式中文字体使用，否则会抛出字符不存在的异常
• 若JSON内容行数较多，需要增加分页逻辑：写入每行前判断当前Y轴坐标是否小于页面下边距阈值（通常设为50单位即可），如果小于则新建空白页，重置写入坐标到新页顶部继续写入，避免内容超出页面范围
• PDPageContentStream的showText()方法不会自动识别\n换行符，必须拆分后逐行写入，否则所有内容会挤在同一行

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