将 Docx4j 文档转换为 PDF 时避免在 /tmp 目录下生成临时图片-java教程-PHP中文网

将 Docx4j 文档转换为 PDF 时避免在 /tmp 目录下生成临时图片

DDD

发布： 2025-08-05 20:24:02

原创

715人浏览过

将 docx4j 文档转换为 pdf 时避免在 /tmp 目录下生成临时图片

本文档旨在解决在使用 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 目录下的所有文件。