Spring Boot项目中Docx4j加载文件遇FileNotFoundException问题求助

问题原因 #

Spring Boot项目打包成jar后，classpath下的资源是嵌入在jar内部的，ResourceUtils.getFile()返回的File对象只是逻辑路径，并非真实的文件系统文件。docx4j的WordprocessingMLPackage.load(File)方法无法直接读取jar内的资源，所以即便file.exists()返回true（这个判断是基于ResourceUtils的逻辑校验，不是真实文件系统的存在性），还是会抛出FileNotFoundException。

修复方案 #

改用**输入流(InputStream)**加载资源，这是Spring Boot读取classpath资源的标准方式，能兼容jar包内外的场景。

方案1：通过ResourceLoader获取资源流 #

import org.springframework.core.io.Resource;
import org.springframework.core.io.ResourceLoader;
import org.springframework.stereotype.Component;

@Component
public class DocxService {

    private final ResourceLoader resourceLoader;

    // 注入ResourceLoader
    public DocxService(ResourceLoader resourceLoader) {
        this.resourceLoader = resourceLoader;
    }

    public void testDocx4j() throws Docx4JException, IOException {
        Resource resource = resourceLoader.getResource("classpath:compare.docx");
        try (InputStream is = resource.getInputStream()) {
            WordprocessingMLPackage wordMLPackage = WordprocessingMLPackage.load(is);
            MainDocumentPart mainDocumentPart = wordMLPackage.getMainDocumentPart();
            // 后续业务操作
        }
    }
}

方案2：直接用ClassPathResource获取流 #

如果不想注入ResourceLoader，也可以直接使用ClassPathResource：

import org.springframework.core.io.ClassPathResource;

public void testDocx4j() throws Docx4JException, IOException {
    ClassPathResource resource = new ClassPathResource("compare.docx");
    try (InputStream is = resource.getInputStream()) {
        WordprocessingMLPackage wordMLPackage = WordprocessingMLPackage.load(is);
        MainDocumentPart mainDocumentPart = wordMLPackage.getMainDocumentPart();
        // 后续业务操作
    }
}

注意事项 #

• 确保compare.docx文件放在src/main/resources目录下，打包后才会被纳入classpath。
• 使用try-with-resources语法自动关闭输入流，避免资源泄漏。

内容的提问来源于stack exchange，提问作者Mohamed Osama