Spring Boot内嵌Tomcat环境下类路径文件访问异常问题咨询

这个问题我之前也踩过坑，核心原因其实是开发环境和打包后运行的文件系统逻辑完全不一样，咱们一步步拆解清楚：

为什么Eclipse里能正常运行？ #

在Eclipse中跑Spring Boot项目时，src/main/resources下的内容会被编译到项目的target/classes目录——这是本地磁盘上的真实文件目录，你下载文件到这里的子文件夹，本质是写入了本地文件系统，所以iframe能通过类路径的静态资源映射直接访问到这些文件。

为什么war包运行时不行？ #

打包成war包后，resources里的所有内容都被打包进了war文件内部。内嵌Tomcat运行这个war时，会把它解压到一个临时目录（比如系统tmp下的tomcat.xxx文件夹），但这个场景有两个致命问题：

1. 你代码里硬编码的类路径路径，在运行时指向的是war解压后的WEB-INF/classes目录，但写入这里的文件会在应用重启后被Tomcat自动清理；
2. 甚至有些情况下war包不会被完全解压，或者你的路径计算逻辑和运行时实际路径不匹配，直接导致找不到文件夹。

正确的解决方案：用外部目录存储文件 #

别再往类路径（resources）里写文件了，这本来就不是类路径资源的设计用途。推荐用外部固定目录来存储下载的文件，步骤如下：

1. 配置存储路径

在application.properties（或application.yml）里添加一行配置，指定你要用来存文件的外部目录：

# 换成你实际想用的路径，Windows下可以写成D:/myapp/downloads/
app.file.storage.path=/var/myapp/downloads/

2. 配置静态资源映射

让Spring Boot的内嵌Tomcat能把这个外部目录的文件当作静态资源访问，写一个简单的配置类：

@Configuration
public class WebResourceConfig implements WebMvcConfigurer {
    @Value("${app.file.storage.path}")
    private String fileStoragePath;

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        // 把URL路径/downloads/**映射到外部存储目录
        registry.addResourceHandler("/downloads/**")
                // 注意要加file:前缀，表示指向本地文件系统路径
                .addResourceLocations("file:" + fileStoragePath);
    }
}

3. 修改下载代码

把原来下载到resources目录的逻辑，改成写入上面配置的fileStoragePath路径：

@Value("${app.file.storage.path}")
private String storagePath;

public void downloadDocument(String fileName) {
    // 替换成你的实际下载逻辑
    File destFile = new File(storagePath + File.separator + fileName);
    // 执行文件下载/保存操作...
}

4. 访问文件

之后在iframe里就可以用http://你的域名/端口/downloads/文件名来访问这些文件了。

额外注意事项 #

• 确保你指定的外部目录有读写权限，不然下载文件时会抛出权限异常；
• 如果只是临时存储文件（重启后丢失也无所谓），可以用系统临时目录：System.getProperty("java.io.tmpdir")，同样配置资源映射即可；
• 绝对不要依赖war包解压后的临时目录，这个路径是Tomcat自动生成的，每次启动都可能变化，而且重启就会被清空。

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