SpringBoot实现文件上传与下载功能的详细教程

<dependencies>
    <!-- SpringBoot Web 核心依赖 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <!-- 工具类（可选，简化开发） -->
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <optional>true</optional>
    </dependency>
</dependencies>

server:
  port: 8080
#文件上传配置
file:
上传文件存储路径（Windows：D:/upload  Linux：/home/upload）
  upload-dir: D:/springboot-file-upload

import jakarta.servlet.http.HttpServletResponse;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;

import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.OutputStream;
import java.net.URLEncoder;
import java.util.UUID;

/**
 * 文件上传下载控制器
 * @author 你的昵称
 */
@RestController
@RequestMapping("/file")
public class FileController {

    // 从配置文件读取上传目录
    @Value("${file.upload-dir}")
    private String uploadDir;

    /**
     * 文件上传接口
     * @param file 前端传递的文件（form-data 格式）
     * @return 上传结果+唯一文件名
     * @throws IOException IO异常
     */
    @PostMapping("/upload")
    public String upload(@RequestParam("file") MultipartFile file) throws IOException {
        // 1. 空文件校验
        if (file.isEmpty()) {
            return "上传失败：文件不能为空";
        }

        // 2. 自动创建上传目录（不存在则创建）
        File directory = new File(uploadDir);
        if (!directory.exists()) {
            directory.mkdirs();
        }

        // 3. 生成唯一文件名（防止文件名重复覆盖）
        String originalFilename = file.getOriginalFilename();
        String suffix = originalFilename.substring(originalFilename.lastIndexOf("."));
        String fileName = UUID.randomUUID() + suffix;

        // 4. 构建文件最终存储路径
        File destFile = new File(uploadDir + File.separator + fileName);

        // 5. 写入文件到本地
        file.transferTo(destFile);

        // 返回唯一文件名（前端下载时需要传递此文件名）
        return "上传成功！唯一文件名：" + fileName;
    }

    /**
     * 文件下载接口
     * @param fileName 上传时返回的唯一文件名
     * @param response 响应对象
     * @throws IOException IO异常
     */
    @GetMapping("/download")
    public void download(@RequestParam("fileName") String fileName,
                         HttpServletResponse response) throws IOException {

        // 1. 构建文件完整路径
        String filePath = uploadDir + File.separator + fileName;
        File file = new File(filePath);

        // 2. 文件不存在校验
        if (!file.exists()) {
            response.getWriter().write("下载失败：文件不存在");
            return;
        }

        // 3. 设置下载响应头（告诉浏览器这是下载文件）
        response.setContentType("application/octet-stream");
        response.setHeader("Content-Disposition", "attachment;filename=" +
                URLEncoder.encode(fileName, "UTF-8"));

        // 4. 读取文件流，输出到前端
        try (FileInputStream fis = new FileInputStream(file);
             OutputStream os = response.getOutputStream()) {

            byte[] buffer = new byte[1024];
            int len;
            // 循环读取文件，写入响应流
            while ((len = fis.read(buffer)) != -1) {
                os.write(buffer, 0, len);
            }
            os.flush();
        }
    }
}

spring:
  servlet:
    multipart:
      max-file-size: 10MB  # 单个文件最大大小
      max-request-size: 100MB  # 单次请求最大大小
权限问题：Linux 服务器需确保应用对上传目录有读写权限
生产环境：建议搭配 Nginx 做文件访问代理，或使用云存储（OSS/COS）