如何使用PDFBox创建PDF/UA无障碍文档？当前代码生成PDF/A

嘿，我懂你现在的处境——本来想做符合PDF/UA标准的无障碍PDF，结果写的代码生成了PDF/A，这确实容易搞混，毕竟俩标准的XMP配置逻辑有点像，但用的类完全不一样。

你之前的代码里用了XMPSchemaPDFAId，这是专门给PDF/A标准准备的XMP schema，所以生成的文档自然会被标记为PDF/A。要生成PDF/UA，得换用PDFBox里专门的PDF/UA元数据类，同时还要满足PDF/UA的其他无障碍要求，光改XMP还不够。

正确的代码示例 #

// 获取或创建文档的XMP元数据
PDDocument document = new PDDocument();
XMPMetadata xmp = document.getXmpMetadata();
if (xmp == null) {
    xmp = XMPMetadata.createXMPMetadata();
    document.setXmpMetadata(xmp);
}

// 添加PDF/UA的专属XMP Schema
XMPSchemaPDFUAId pdfuaid = new XMPSchemaPDFUAId(xmp);
xmp.addSchema(pdfuaid);
// 设置PDF/UA的版本，目前主流是Part 1
pdfuaid.setPart(1);

// 关键！PDF/UA不止是元数据标记，还必须满足这些无障碍要求：
// - 开启文档标签：document.setTagged(true);
// - 给所有非文本元素（图片、形状）添加替代文本（比如PDImageXObject的setAlternateDescription）
// - 设置文档的语言属性：document.setLanguage("zh-CN"); // 根据实际语言调整
// - 确保文档结构符合逻辑（比如正确添加标题、段落等结构元素）
// - 避免仅依赖颜色传递信息，保证颜色对比度符合无障碍标准

额外提醒 #

PDF/UA的核心是无障碍可访问性，XMP标记只是告诉阅读器这是PDF/UA文档，但真正的合规性需要你确保文档的内容结构、交互逻辑都符合无障碍规范。建议生成后用专门的PDF/UA验证工具（比如Adobe Acrobat的无障碍检查器）扫一遍，确认所有要求都达标。

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