将 Docx4j 文档转换为 PDF 时删除临时图片-java教程-PHP中文网

将 Docx4j 文档转换为 PDF 时删除临时图片

碧海醫心

发布： 2025-08-05 20:22:17

原创

999人浏览过

将 docx4j 文档转换为 pdf 时删除临时图片

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