当前位置：首页 > 文章列表 > 文章 > java教程 > Docx4j转PDF如何处理临时图片

Docx4j转PDF如何处理临时图片

2025-08-06 08:39:38 0浏览收藏

本篇文章主要是结合我之前面试的各种经历和实战开发中遇到的问题解决经验整理的，希望这篇《Docx4j转PDF如何处理临时图片文件》对你有很大帮助！欢迎收藏，分享给更多的需要的朋友学习~

将 Docx4j 文档转换为 PDF 时如何处理临时图片文件

在使用 Docx4j 将 Word 文档转换为 PDF 时，特别是通过 XSL-FO 转换方式，经常会遇到临时图片文件管理的问题。尤其是在 Linux 环境下，页眉/页脚中的图片会被保存在默认的 /tmp 目录下，这给清理这些临时文件带来了不便。本文将深入探讨这个问题，并提供一种有效的解决方案。

问题分析

Docx4j 使用 AbstractConversionImageHandler.java 处理图片转换，该类在 XSL-FO 转换过程中会默认存储图片。虽然可以通过设置 FOSettings 的 ImageDirPath 属性来指定图片保存路径，但这个设置仅对文档主体中的图片生效，对页眉/页脚中的图片无效。

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));
}

上述代码中，只有文档主体中的图片会被保存到 TEMP_IMAGE_DIR_PATH 目录，并随后被删除。而页眉中的图片仍然会被保存到 /tmp 目录，且无法通过 ImageDirPath 属性进行控制。