本文档旨在解决在使用 Docx4j 将 Word 文档转换为 PDF 时，由于页眉/页脚中的图片被保存在默认的 /tmp 目录下而导致的问题。我们将分析问题原因，并提供一种规避该问题的临时解决方案，最终帮助开发者避免在转换过程中产生不需要的临时图片文件。
问题描述
在使用 Docx4j 将包含图片的 Word 文档转换为 PDF 格式时，通过 XSL-FO 转换，有时会发现图片被保存到 /tmp 目录下。这是因为 AbstractConversionImageHandler.java 在使用 XSL-FO 时，默认会将图片存储到临时目录。虽然可以通过设置 FOSettings 的 ImageDirPath 属性来指定图片保存路径，但此设置对页眉/页脚中的图片无效，这些图片仍然会被保存在默认的 /tmp 目录下。即使尝试使用 FopAreeTreeHelper，它也会使用 FOP 的默认设置，导致页眉/页脚图片被保存到 /tmp 目录。
以下是一个示例代码，展示了如何使用 Docx4j 将 Word 文档转换为 PDF，并尝试设置图片保存路径：
private static final String TEMP_IMAGE_DIR_PATH = "/tmp/images";
public static void convert(WordprocessingMLPackage wordMLPackage, OutputStream output) throws Exception {
Mapper fontMapper = new BestMatchingMapper();
wordMLPackage.setFontMapper(fontMapper);
FOSettings foSettings = new FOSettings(wordMLPackage);
foSettings.setApacheFopMime("application/pdf");
foSettings.setImageDirPath(TEMP_IMAGE_DIR_PATH);
foSettings.setFoDumpFile(null);
FopFactoryBuilder fopFactoryBuilder = FORendererApacheFOP.getFopFactoryBuilder(foSettings) ;
FopFactory fopFactory = fopFactoryBuilder.build();
FOUserAgent foUserAgent = FORendererApacheFOP.getFOUserAgent(foSettings, fopFactory);
Docx4J.toFO(foSettings, output, Docx4J.FLAG_EXPORT_PREFER_XSL);
// Clean up, so any ObfuscatedFontPart temp files can be deleted
if (wordMLPackage.getMainDocumentPart().getFontTablePart()!=null) {
wordMLPackage.getMainDocumentPart().getFontTablePart().deleteEmbeddedFontTempFiles();
}
foSettings = null;
wordMLPackage = null;
FileUtils.deleteDirectory(new File(TEMP_IMAGE_DIR_PATH));
}这段代码尝试将文档主体中的图片保存到 /tmp/images 目录下，并在转换后删除该目录。但页眉/页脚中的图片仍然会被保存到 /tmp 目录下，而我们通常不希望删除 /tmp 目录下的所有文件。
解决方案
根据已知信息，这实际上是 Docx4j 库中的一个 Bug，并且已经被报告为一个 Issue。在官方修复之前，我们可以采用一种规避方案：避免在页眉和页脚中放置图片。
虽然这可能不是一个理想的解决方案，但它可以有效避免在 /tmp 目录下生成不需要的临时图片文件。 如果必须使用页眉/页脚图片，可以考虑将图片嵌入到文档主体部分，然后通过布局实现类似页眉/页脚的效果。
总结
在使用 Docx4j 将 Word 文档转换为 PDF 时，如果遇到页眉/页脚图片被保存在 /tmp 目录下的问题，可以考虑避免在页眉/页脚中使用图片作为临时解决方案。 期待 Docx4j 官方能够尽快修复此问题，提供更完善的图片处理机制。
