如何通过Spring/Spring Boot实现文件上传并将上传文件作为静态资源访问？

当然可以实现啦！完全不用依赖外部服务器或者AWS S3，我帮你梳理清楚步骤，解决你静态资源映射不生效的问题～

一、先搞定基础文件上传配置 #

首先得先配置文件上传的基础参数，比如存储路径、文件大小限制，在application.properties（或application.yml）里加这些配置：

# 文件上传大小限制
spring.servlet.multipart.max-file-size=10MB
spring.servlet.multipart.max-request-size=10MB
# 自定义本地存储目录（建议用项目外的绝对路径，避免重启/打包丢失文件）
app.upload.dir=/data/upload-files/

然后写个文件上传服务类，处理文件存储逻辑：

@Service
public class FileUploadService {

    @Value("${app.upload.dir}")
    private String uploadDir;

    // 项目启动时自动创建存储目录
    @PostConstruct
    public void initUploadDir() {
        File dir = new File(uploadDir);
        if (!dir.exists()) {
            dir.mkdirs();
        }
    }

    public String uploadFile(MultipartFile file) throws IOException {
        // 生成唯一文件名，避免重名覆盖
        String uniqueFileName = UUID.randomUUID().toString() + "_" + file.getOriginalFilename();
        File destFile = new File(uploadDir + uniqueFileName);
        // 复制文件到目标路径
        Files.copy(file.getInputStream(), destFile.toPath(), StandardCopyOption.REPLACE_EXISTING);
        // 返回文件名，用于后续生成访问路径
        return uniqueFileName;
    }
}

再写个Controller处理上传请求：

@RestController
@RequestMapping("/api/upload")
public class FileUploadController {

    @Autowired
    private FileUploadService uploadService;

    @PostMapping
    public ResponseEntity<String> upload(@RequestParam("file") MultipartFile file) {
        try {
            String fileName = uploadService.uploadFile(file);
            // 返回前端可直接访问的路径
            String accessUrl = "/files/" + fileName;
            return ResponseEntity.ok(accessUrl);
        } catch (IOException e) {
            return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("文件上传失败");
        }
    }
}

二、关键：配置静态资源映射（解决你不生效的问题） #

Spring Boot默认只认classpath:/static/、classpath:/public/这些目录的静态资源，你的文件存在自定义目录里，必须手动配置映射规则，有两种方式：

方式1：配置文件快速实现 #

在application.properties里加一行：

# 把自定义上传目录加入静态资源位置，访问路径/files/** 对应到本地目录
spring.web.resources.static-locations=file:${app.upload.dir},classpath:/static/,classpath:/public/

⚠️ 注意file:前缀不能丢，它告诉Spring这是本地文件系统路径，不是classpath资源。

方式2：Java配置类（更灵活，推荐） #

如果需要加缓存控制、权限拦截等复杂逻辑，写个WebMvcConfigurer配置类：

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {

    @Value("${app.upload.dir}")
    private String uploadDir;

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        // 映射访问路径/files/**到本地上传目录
        registry.addResourceHandler("/files/**")
                .addResourceLocations("file:" + uploadDir)
                // 可选：设置缓存时间，比如1天（单位秒）
                .setCacheControl(CacheControl.maxAge(1, TimeUnit.DAYS).cachePublic());
    }
}

三、避坑注意事项 #

• 存储路径别选项目内：不要把文件存在src/main/resources/static这类classpath目录里，打包后这些目录是只读的，重启项目文件会丢失，尽量用项目外的绝对路径。
• 文件名必须唯一：一定要用UUID、时间戳等方式生成唯一文件名，防止用户上传同名文件覆盖旧文件。
• 权限控制按需加：如果需要限制文件访问（比如仅登录用户可看），可以在资源映射里加拦截器，或者写个Controller做权限校验后重定向到文件路径。

测试验证 #

1. 启动项目，用Postman/表单上传文件到/api/upload，会拿到类似/files/xxxx-xxxx.jpg的访问路径。
2. 浏览器直接访问http://localhost:8080/files/xxxx-xxxx.jpg，能看到上传的文件就说明配置生效啦！

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