Pdfbox 3.0.0-RC1生成PDF损坏缺失xref 2.0.24版本正常问题咨询

你遇到的情况属于该预发布版本的已知问题，并非代码逻辑错误：

• 3.0.0-RC1是PDFBox 3.x的早期测试版本，默认启用了*压缩交叉引用流（Compressed XRef）*特性，同时该版本在压缩交叉引用的生成逻辑上存在规范兼容性缺陷，导致生成的PDF结构无法被大部分PDF阅读器识别，被判定为损坏文件。而2.0.24属于2.x稳定分支，默认使用传统明文交叉引用结构，不存在该问题。
• 你提供的3.0.0-RC1生成的文件结构中并非完全缺失交叉引用，而是使用了新的流式交叉引用结构（即文件中9号/Type为/XRef的对象），但该结构的生成结果不符合PDF规范要求，最终导致解析失败。

解决方案 #

你可以选择以下任意一种方式解决该问题：

1. 升级到PDFBox 3.x正式稳定版，目前最新的3.0.2版本已经修复了该预发布版本的交叉引用生成缺陷，原有代码无需修改即可正常生成符合规范的PDF文件。
2. 若暂时需要使用3.0.0-RC1版本，可在保存文档前手动指定使用传统明文交叉引用模式，添加一行代码即可：

document.setXRefMode(XRefMode.CLASSIC);

修改后的完整参考代码如下：

ByteArrayOutputStream output = new ByteArrayOutputStream();
try (PDDocument document = new PDDocument()) {
    // 强制使用传统明文交叉引用结构，规避RC1版本的压缩XRef缺陷
    document.setXRefMode(XRefMode.CLASSIC);
    PDPage page = new PDPage();
    document.addPage(page);

    try (PDPageContentStream contentStream = new PDPageContentStream(document, page)) {
        contentStream.beginText();
        contentStream.setFont(PDType1Font.TIMES_ROMAN, 12);
        contentStream.setLeading(14.5f);
        contentStream.newLineAtOffset(25, 700);
        contentStream.showText("Hello World");
        contentStream.endText();
    }

    document.save(output);
} catch (Exception e) {
    e.printStackTrace();
}

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