PDFBox 3.2生成PDF/UA时PAC提示图片标签缺失Bounding Box错误

使用PDFBox 3.2创建PDF/UA文档时，已完成文本和图片的标记，PAC工具显示图片标签正确，但提示图片缺失Bounding Box错误。尝试过给标记内容加矩形、给Figure结构元素/引用添加COSName.BBOX均无效或导致PDF损坏。

正确解决方案 #

PDF/UA要求结构元素的Bounding Box需通过结构元素的BBox属性定义，直接操作底层字典易导致PDF损坏，需使用PDFBox提供的官方API正确设置：

1. 确认图片在PDF页面坐标系中的准确位置（原点为页面左下角，单位为用户空间单位）
2. 为PDStructureElement（即Figure元素）调用setBBox()方法传入PDRectangle对象，而非直接修改字典

修正后的代码 #

COSDictionary markedContentDictionary3 = new COSDictionary();
markedContentDictionary3.setInt(COSName.MCID, mcidCounter + 2);
markedContentDictionary3.setString(COSName.ALT, "Alternate Image Description");

PDMarkedContentReference mcr3 = new PDMarkedContentReference();
mcr3.setMCID(mcidCounter + 2);

contentStream.beginMarkedContent(COSName.IMAGE, PDPropertyList.create(markedContentDictionary3));
contentStream.drawImage(image, x, y, width, height);
contentStream.endMarkedContent();
contentStream.close();

// 创建Figure结构元素
PDStructureElement figureElement = new PDStructureElement(StandardStructureTypes.Figure, documentElement);
figureElement.setPage(page);
figureElement.setAlternateDescription("Dieses Bild zeigt: <dein_Tag_oder_Beschriftung>");

// 关键：通过API设置Bounding Box
PDRectangle bbox = new PDRectangle(x, y, width, height);
figureElement.setBBox(bbox);

figureElement.appendKid(mcr3);
documentElement.appendKid(figureElement);

注意事项 #

• 确保x,y,width,height为图片在页面上的真实坐标值，若使用自定义坐标系需先转换为PDF标准坐标系
• 禁止直接修改figureElement或PDMarkedContentReference的底层COSDictionary添加BBOX项，PDFBox的setBBox()方法会自动处理字典的合规性，避免PDF损坏
• 重新生成文档后，PAC工具应能识别到Figure元素的Bounding Box，消除错误提示

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