本文档旨在解决在使用 Docx4j 将 Word 文档转换为 PDF 时，页眉和页脚中的图片被保存在默认的 /tmp 目录下，导致无法有效清理临时文件的问题。文章将阐述该问题的根本原因，并提供一个临时解决方案，即避免在页眉和页脚中使用图片，同时指出该问题已作为 Bug 提交给 Docx4j 官方。
在使用 Docx4j 将 .docx 文件转换为 PDF 格式时，特别是通过 XSL-FO 转换，你可能会遇到一个问题：文档中的图片会被保存在临时文件夹中，通常是 /tmp 目录。这是由于 AbstractConversionImageHandler.java 的默认行为所致，它在 XSL-FO 转换过程中总是会存储图片。
虽然可以通过设置 FOSettings 中的 ImageDirPath 属性来指定图片保存路径，但这个设置对于页眉和页脚中的图片无效。这是因为在计算页眉和页脚区域大小时，FopAreeTreeHelper 使用 FOP 时采用了一些默认设置，导致页眉和页脚中的图片会被保存在默认的 /tmp 目录下。
以下是一个示例代码，展示了如何使用 Docx4j 将 Word 文档转换为 PDF，并尝试设置图片保存路径：
import org.docx4j.Docx4J;
import org.docx4j.fonts.Mapper;
import org.docx4j.fonts.BestMatchingMapper;
import org.docx4j.openpackaging.packages.WordprocessingMLPackage;
import org.docx4j.convert.out.FOSettings;
import org.docx4j.convert.out.FORendererApacheFOP;
import org.apache.fop.apps.FopFactory;
import org.apache.fop.apps.FopFactoryBuilder;
import org.apache.fop.apps.FOUserAgent;
import org.apache.commons.io.FileUtils;
import java.io.File;
import java.io.OutputStream;
public class DocxToPdfConverter {
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));
}
}上述代码尝试将文档主体中的图片保存到 TEMP_IMAGE_DIR_PATH 目录，并在转换完成后删除该目录。然而，如前所述，页眉和页脚中的图片仍然会被保存在 /tmp 目录下。
当前解决方案和注意事项：
由于这是 Docx4j 库中的一个 Bug，目前官方尚未提供直接的解决方案。临时解决方案是避免在页眉和页脚中使用图片。
总结：
虽然可以通过 FOSettings 设置图片路径，但该设置对页眉和页脚无效。目前最好的方法是避免在页眉和页脚中使用图片，并关注 Docx4j 官方的更新，以期未来能够修复此问题。 建议在 Docx4j 的 issue 跟踪系统中关注此问题，以便及时获取修复信息。
