使用docx4j将docx转PDF时图片边框丢失问题咨询

结论 #

这不是预期行为，docx4j的PDF导出功能应当支持Word添加的图片边框，出现这个问题大概率是版本兼容性或导出配置缺失导致的。

可能的原因及解决方法 #

• 版本兼容性问题：
  旧版docx4j对Word图片边框的样式解析支持不完善，建议升级到docx4j 11.x及以上的稳定版本，新版本对Office Open XML的样式解析和PDF渲染兼容性更强。

• 缺失PDF导出配置：
  默认的Docx4J.toPDF()方法使用内置转换器，可能需要显式配置渲染选项来确保边框样式被正确识别。可以尝试自定义PdfSettings补充配置：

String outputfilepath = "/tmp/message.pdf";
FileOutputStream os = new FileOutputStream(outputfilepath);

// 自定义PDF导出配置
PdfSettings pdfSettings = new PdfSettings();
pdfSettings.setWmlPackage(wordMLPackage);
// 启用Word样式保留特性
pdfSettings.getConversionFeatures().add(ConversionFeature.PRESERVE_WORD_STYLES);

Docx4J.toPDF(wordMLPackage, os, pdfSettings);
os.flush();
os.close();

• 边框样式的XML解析问题：
  Word通过「图片工具→格式→图片边框」添加的边框，会存储在文档XML的a:ln（线条属性）节点中。如果docx4j未正确解析该节点，你可以手动检查模板的XML结构，确认边框属性是否存在；必要时可通过代码手动为图片节点补充边框渲染参数。

• 尝试替代转换引擎：
  若默认转换器仍无法解决问题，可以尝试使用docx4j支持的其他PDF转换引擎（如Apache FOP），不过这需要额外添加对应依赖并调整转换逻辑。

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