SpringBoot文件上傳的幾種常見方式(單文件上傳、多文件上傳)

更新時間：2025年08月22日 10:13:43 作者：1加1等于

本文詳解SpringBoot文件上傳實現(xiàn),涵蓋單文件、多文件上傳及大小類型限制方法,強調(diào)隱私保護與非法文件防范的社會責任,適配不同場景需求,提供技術(shù)解決方案與合規(guī)實踐指導,感興趣的朋友跟隨小編一起看看吧

文件上傳功能在很多系統(tǒng)中都占據(jù)非常重要的份置，軟件開發(fā)人員在實現(xiàn)文件上傳時，除了需要確保程序代碼的穩(wěn)健性和高維護性外，還需要從社會責任的角度審的需求，秉承合法、合規(guī)的職業(yè)理念進行數(shù)據(jù)讀寫，避免程序在保存用戶上傳的文件時造成不良的社會影響。例如，應該關(guān)注保護用戶的隱私，避免用戶的隱私泄露，以及杜絕上傳非法文件。

文件上傳的常見場景

在日常開發(fā)中，文件上傳的場景多種多樣。比如，在線教育平臺上的視頻資源上傳，社交平臺上的圖片分享，以及企業(yè)內(nèi)部的知識文檔管理等。這些場景對文件上傳的要求也各不相同，有的追求速度，有的注重穩(wěn)定性，還有的需要考慮文件大小和安全性。因此，針對不同需求，我們有了秒傳、斷點續(xù)傳和分片上傳等解決方案。

文件上傳是一個常見的需求。例如社交平臺用戶上傳頭像、電商系統(tǒng)商家上傳商品圖片、文檔管理系統(tǒng)用戶上傳資料等都會用到。本文詳細介紹SpringBoot關(guān)于單文件上傳、多文件上傳以及限制文件大小和類型等幾種常見方式。

1. 單文件上傳

單文件上傳是最基礎的文件上傳場景，當用戶選擇一個文件并提交到服務器，可以使用 MultipartFile 類型來接收上傳的文件。

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.multipart.MultipartFile;
import java.io.File;
import java.io.IOException;
@Controller
public class SingleFileUploadController {
    @PostMapping("/singleFileUpload")
    @ResponseBody
    public String singleFileUpload(@RequestParam("file") MultipartFile file) {
        if (file.isEmpty()) {
            return "請選擇要上傳的文件";
        }
        try {
            // 獲取文件名
            String fileName = file.getOriginalFilename();
            // 定義文件存儲路徑
            String filePath = "uploads/";
            File dest = new File(filePath + fileName);
            // 檢查目錄是否存在，不存在則創(chuàng)建
            if (!dest.getParentFile().exists()) {
                dest.getParentFile().mkdirs();
            }
            // 保存文件
            file.transferTo(dest);
            return "文件上傳成功";
        } catch (IOException e) {
            e.printStackTrace();
            return "文件上傳失敗";
        }
    }
}

index.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>單文件上傳</title>
</head>
<body>
    <form action="/singleFileUpload" method="post" enctype="multipart/form-data">
        <input type="file" name="file">
        <input type="submit" value="上傳">
    </form>
</body>
</html>

enctype="multipart/form-data"是必須的

2. 多文件上傳

多文件上傳允許用戶一次選擇多個文件進行上傳?？梢允褂?MultipartFile 數(shù)組來接收多個上傳的文件。

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.multipart.MultipartFile;
import java.io.File;
import java.io.IOException;
@Controller
public class MultipleFileUploadController {
    @PostMapping("/multipleFileUpload")
    @ResponseBody
    public String multipleFileUpload(@RequestParam("files") MultipartFile[] files) {
        if (files.length == 0) {
            return "請選擇要上傳的文件";
        }
        for (MultipartFile file : files) {
            if (file.isEmpty()) {
                continue;
            }
            try {
                String fileName = file.getOriginalFilename();
                String filePath = "uploads/";
                File dest = new File(filePath + fileName);
                if (!dest.getParentFile().exists()) {
                    dest.getParentFile().mkdirs();
                }
                file.transferTo(dest);
            } catch (IOException e) {
                e.printStackTrace();
                return "文件上傳失敗";
            }
        }
        return "文件上傳成功";
    }
}

index.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>多文件上傳</title>
</head>
<body>
    <form action="/multipleFileUpload" method="post" enctype="multipart/form-data">
        <input type="file" name="files" multiple>
        <input type="submit" value="上傳">
    </form>
</body>
</html>

input組件需要 multiple 支持多文件選擇

3. 限制文件大小和類型

在實際開發(fā)的時候，可能需要對上傳的文件大小和類型進行限制?？梢酝ㄟ^配置SpringBoot的 MultipartConfigElement 來實現(xiàn)文件大小限制，同時在代碼中檢查文件類型。

import org.springframework.boot.web.servlet.MultipartConfigFactory;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.util.unit.DataSize;
import javax.servlet.MultipartConfigElement;
@Configuration
public class MultipartConfig {
    @Bean
    public MultipartConfigElement multipartConfigElement() {
        MultipartConfigFactory factory = new MultipartConfigFactory();
        // 單個文件最大10MB
        factory.setMaxFileSize(DataSize.ofMegabytes(10));
        // 設置總上傳數(shù)據(jù)總大小20MB
        factory.setMaxRequestSize(DataSize.ofMegabytes(20));
        return factory.createMultipartConfig();
    }
}

檢查文件類型：

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.multipart.MultipartFile;
import java.io.File;
import java.io.IOException;
@Controller
public class FileUploadWithLimitController {
    @PostMapping("/fileUploadWithLimit")
    @ResponseBody
    public String fileUploadWithLimit(@RequestParam("file") MultipartFile file) {
        if (file.isEmpty()) {
            return "請選擇要上傳的文件";
        }
        // 檢查文件類型
        String contentType = file.getContentType();
        if (!"image/jpeg".equals(contentType) && !"image/png".equals(contentType)) {
            return "只允許上傳jpeg和png格式文件";
        }
        try {
            String fileName = file.getOriginalFilename();
            String filePath = "uploads/";
            File dest = new File(filePath + fileName);
            if (!dest.getParentFile().exists()) {
                dest.getParentFile().mkdirs();
            }
            file.transferTo(dest);
            return "文件上傳成功";
        } catch (IOException e) {
            e.printStackTrace();
            return "文件上傳失敗";
        }
    }
}

getContentType 方法可以獲取文件的MIME類型

到此這篇關(guān)于SpringBoot實戰(zhàn)——文件上傳一篇搞定的文章就介紹到這了,更多相關(guān)SpringBoot文件上傳內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: