Spring Boot中文件应存储在哪个位置，生产构建环境也可正常访问？

存储位置选择 #

你当前将文件存放在pom.xml同级目录的方案仅适用于本地开发阶段，项目打包成jar/war运行后该目录不存在，生产环境完全无法读取写入的文件，必须调整存储位置。

推荐按场景选择以下存储位置：

• 操作系统固定目录：生产环境最推荐该方案，比如Linux下的/data/你的项目名/upload、Windows下的D:\data\你的项目名\upload，该目录和Spring Boot打包后的运行文件完全解耦，不会因项目重新构建、升级部署丢失文件。
• 应用运行工作目录：如果不想固定系统路径，也可以存放在启动jar包时的当前工作目录下的自定义子目录，只要部署时固定启动命令的执行路径即可稳定访问。
• 对象存储服务：如果有分布式部署、多实例共享文件的需求，推荐对接MinIO、云厂商OSS等对象存储服务，无需考虑本地路径问题，生产扩展性更强。

路径获取与访问配置代码实现 #

推荐通过配置文件注入存储路径，方便开发、生产环境灵活切换：

1. 配置文件配置存储路径 #

在application.yml中添加如下配置：

file:
  # 生产环境替换为实际的服务器存储路径
  storage-path: /data/your-project/upload
  # 本地开发时可以临时改为 ./dev-storage 测试使用

2. 存储路径获取工具类 #

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;
import java.io.File;
import java.nio.file.Path;
import java.nio.file.Paths;

@Component
public class FileStorageUtil {
    @Value("${file.storage-path}")
    private String storagePath;

    // 获取存储根路径，目录不存在时自动创建
    public Path getStorageRootPath() {
        File rootDir = new File(storagePath);
        if (!rootDir.exists()) {
            rootDir.mkdirs();
        }
        return rootDir.toPath();
    }

    // 拼接获取单个文件的完整存储路径
    public Path getFullFilePath(String fileName) {
        return Paths.get(getStorageRootPath().toString(), fileName);
    }
}

3. 配置HTTP访问映射（可选） #

如果需要让存储的文件可以直接通过HTTP接口访问，添加Spring MVC静态资源映射配置即可：

import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

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

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        // 配置访问前缀 /file/** 映射到实际存储目录
        registry.addResourceHandler("/file/**")
                .addResourceLocations("file:" + storagePath + "/");
    }
}

配置完成后，存储在目标目录下的test.png文件，可以直接通过http://你的服务地址/file/test.png访问。

注意事项 #

• 生产环境部署时，需要给配置的存储目录开通Spring Boot应用运行账号的读写权限，避免出现权限不足无法读写的问题。
• 不要把用户上传的文件存放在项目的resources目录下，项目打包后resources目录是只读的，无法写入新文件，重新部署也会丢失所有历史文件。
• 多实例部署场景不要使用本地路径存储，会出现文件跨实例无法访问的问题，优先选择对象存储或者共享存储挂载。

内容的提问来源于stack exchange，提问作者Praphul S Sreedhar