<dependencies>
    <!-- SpringBoot Web 核心依賴(lài) -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <!-- 工具類(lèi)（可選，簡(jiǎn)化開(kāi)發(fā)） -->
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <optional>true</optional>
    </dependency>
</dependencies>

server:
  port: 8080
#文件上傳配置
file:
上傳文件存儲(chǔ)路徑（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 你的昵稱(chēng)
 */
@RestController
@RequestMapping("/file")
public class FileController {

    // 從配置文件讀取上傳目錄
    @Value("${file.upload-dir}")
    private String uploadDir;

    /**
     * 文件上傳接口
     * @param file 前端傳遞的文件（form-data 格式）
     * @return 上傳結(jié)果+唯一文件名
     * @throws IOException IO異常
     */
    @PostMapping("/upload")
    public String upload(@RequestParam("file") MultipartFile file) throws IOException {
        // 1. 空文件校驗(yàn)
        if (file.isEmpty()) {
            return "上傳失?。何募荒転榭?;
        }

        // 2. 自動(dòng)創(chuàng)建上傳目錄（不存在則創(chuàng)建）
        File directory = new File(uploadDir);
        if (!directory.exists()) {
            directory.mkdirs();
        }

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

        // 4. 構(gòu)建文件最終存儲(chǔ)路徑
        File destFile = new File(uploadDir + File.separator + fileName);

        // 5. 寫(xiě)入文件到本地
        file.transferTo(destFile);

        // 返回唯一文件名（前端下載時(shí)需要傳遞此文件名）
        return "上傳成功！唯一文件名：" + fileName;
    }

    /**
     * 文件下載接口
     * @param fileName 上傳時(shí)返回的唯一文件名
     * @param response 響應(yīng)對(duì)象
     * @throws IOException IO異常
     */
    @GetMapping("/download")
    public void download(@RequestParam("fileName") String fileName,
                         HttpServletResponse response) throws IOException {

        // 1. 構(gòu)建文件完整路徑
        String filePath = uploadDir + File.separator + fileName;
        File file = new File(filePath);

        // 2. 文件不存在校驗(yàn)
        if (!file.exists()) {
            response.getWriter().write("下載失?。何募淮嬖?);
            return;
        }

        // 3. 設(shè)置下載響應(yīng)頭（告訴瀏覽器這是下載文件）
        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;
            // 循環(huán)讀取文件，寫(xiě)入響應(yīng)流
            while ((len = fis.read(buffer)) != -1) {
                os.write(buffer, 0, len);
            }
            os.flush();
        }
    }
}

spring:
  servlet:
    multipart:
      max-file-size: 10MB  # 單個(gè)文件最大大小
      max-request-size: 100MB  # 單次請(qǐng)求最大大小
權(quán)限問(wèn)題：Linux 服務(wù)器需確保應(yīng)用對(duì)上傳目錄有讀寫(xiě)權(quán)限
生產(chǎn)環(huán)境：建議搭配 Nginx 做文件訪(fǎng)問(wèn)代理，或使用云存儲(chǔ)（OSS/COS）