Spring Boot可执行Jar中无法读取资源文件问题求助

问题根源 #

打包成可执行Jar后，资源文件是Jar包内的一个压缩条目，并非文件系统中的独立文件，因此依赖绝对文件路径的读取方式必然失效。

具体解决方案 #

1. 优先使用输入流读取资源 #

直接通过Resource对象获取输入流处理，不要尝试转换为File对象，这是最通用的解决方案：

@Component
public class ExcelTemplateProcessor {
    @Value("classpath:Graphic.xlsx")
    private Resource excelTemplateFile;

    public void handleTemplate() throws IOException {
        // 用try-with-resources自动关闭流
        try (InputStream templateStream = excelTemplateFile.getInputStream()) {
            // 示例：用Apache POI处理Excel
            Workbook workbook = WorkbookFactory.create(templateStream);
            // 执行你的业务逻辑，比如读取sheet、修改内容等
        }
    }
}

2. 禁用ResourceUtils工具类 #

ResourceUtils是Spring内部调试工具，不适合在生产代码中使用——它会强制尝试将资源解析为文件系统路径，在Jar环境下必然抛出你遇到的错误，直接弃用即可。

3. 特殊场景：必须使用File对象的处理方式 #

如果你的业务代码依赖File对象（比如某些老旧第三方库），可以将Jar内的资源复制到临时文件后使用：

public File getTempTemplateFile() throws IOException {
    File tempFile = File.createTempFile("Graphic_", ".xlsx");
    // 复制流到临时文件
    try (InputStream is = excelTemplateFile.getInputStream();
         OutputStream os = new FileOutputStream(tempFile)) {
        byte[] buffer = new byte[1024];
        int bytesRead;
        while ((bytesRead = is.read(buffer)) != -1) {
            os.write(buffer, 0, bytesRead);
        }
    }
    // JVM退出时自动删除临时文件
    tempFile.deleteOnExit();
    return tempFile;
}

如果不想自己实现流复制，可以引入Apache Commons IO依赖简化代码：

<dependency>
    <groupId>commons-io</groupId>
    <artifactId>commons-io</artifactId>
    <version>2.11.0</version>
</dependency>

之后可以用IOUtils.copy(is, os);替代手动流复制逻辑。

4. 验证资源打包配置 #

确保资源文件被正确打包到Jar中：

• 执行命令jar tf target\myapp-0.0.2-SNAPSHOT.jar | findstr Graphic.xlsx（Windows环境），检查输出是否包含BOOT-INF/classes/Graphic.xlsx
• 如果资源未被打包，检查pom.xml的资源配置，确保没有过滤或排除该文件：

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>**/*</include>
            </includes>
            <!-- 二进制文件（如xlsx）不要开启过滤，避免文件损坏 -->
            <filtering>false</filtering>
        </resource>
    </resources>
</build>

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