SpringBoot實現(xiàn)文件上傳下載的7種方法
更新時間：2025年05月15日 08:19:24 作者：風象南
文件上傳下載功能是Web應用中的常見需求,從簡單的用戶頭像上傳到大型文件的傳輸與共享,都需要可靠的文件處理機制,下面我們來看看SpringBoot中處理文件上傳下載的7種方法吧
文件上傳下載功能是Web應用中的常見需求，從簡單的用戶頭像上傳到大型文件的傳輸與共享，都需要可靠的文件處理機制。
SpringBoot作為流行的Java應用開發(fā)框架，提供了多種實現(xiàn)文件上傳下載的工具和方案。
本文將介紹七種在SpringBoot中處理文件上傳下載的工具。
1. MultipartFile接口 - 基礎文件上傳處理
SpringBoot內(nèi)置的MultipartFile接口是處理文件上傳的基礎工具，簡單易用且功能完善。
配置方式
在application.properties或application.yml中配置上傳參數(shù)：
spring:
servlet:
multipart:
max-file-size: 10MB
max-request-size: 10MB
enabled: true使用示例
@RestController
@RequestMapping("/api/files")
public class FileUploadController {
@PostMapping("/upload")
public String uploadFile(@RequestParam("file") MultipartFile file) {
if (file.isEmpty()) {
return "請選擇要上傳的文件";
}
try {
// 獲取文件名
String fileName = file.getOriginalFilename();
// 獲取文件類型
String contentType = file.getContentType();
// 獲取文件內(nèi)容
byte[] bytes = file.getBytes();
// 創(chuàng)建存儲路徑
Path path = Paths.get("uploads/" + fileName);
Files.createDirectories(path.getParent());
// 保存文件
Files.write(path, bytes);
return "文件上傳成功: " + fileName;
} catch (IOException e) {
e.printStackTrace();
return "文件上傳失敗: " + e.getMessage();
}
}
}優(yōu)勢與適用場景
優(yōu)勢
- SpringBoot原生支持，無需額外依賴
- 配置簡單，API友好
- 支持多種文件操作方法
適用場景
- 小到中型文件的上傳
- 基礎的文件處理需求
- 快速開發(fā)原型
2. Apache Commons FileUpload - 靈活的文件上傳庫
雖然SpringBoot內(nèi)部已集成文件上傳功能，但在某些場景下，可能需要Apache Commons FileUpload提供的更多高級特性。
配置方式
添加依賴：
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.5</version>
</dependency>配置Bean：
@Bean
public CommonsMultipartResolver multipartResolver() {
CommonsMultipartResolver resolver = new CommonsMultipartResolver();
resolver.setDefaultEncoding("UTF-8");
resolver.setMaxUploadSize(10485760); // 10MB
resolver.setMaxUploadSizePerFile(2097152); // 2MB
return resolver;
}使用示例
@RestController
@RequestMapping("/api/commons")
public class CommonsFileUploadController {
@PostMapping("/upload")
public String handleFileUpload(HttpServletRequest request) throws Exception {
// 判斷是否包含文件上傳
boolean isMultipart = ServletFileUpload.isMultipartContent(request);
if (!isMultipart) {
return "不是有效的文件上傳請求";
}
// 創(chuàng)建上傳器
DiskFileItemFactory factory = new DiskFileItemFactory();
ServletFileUpload upload = new ServletFileUpload(factory);
// 解析請求
List<FileItem> items = upload.parseRequest(request);
for (FileItem item : items) {
if (!item.isFormField()) {
// 處理文件項
String fileName = FilenameUtils.getName(item.getName());
File uploadedFile = new File("uploads/" + fileName);
item.write(uploadedFile);
return "文件上傳成功: " + fileName;
}
}
return "未找到要上傳的文件";
}
}優(yōu)勢與適用場景
優(yōu)勢
- 提供更細粒度的控制
- 支持文件上傳進度監(jiān)控
- 可自定義文件存儲策略
適用場景
- 需要對上傳過程進行細粒度控制
- 大文件上傳并監(jiān)控進度
- 遺留系統(tǒng)集成
3. Spring Resource抽象 - 統(tǒng)一資源訪問
Spring的Resource抽象提供了對不同來源資源的統(tǒng)一訪問方式，非常適合文件下載場景。
使用示例
@RestController
@RequestMapping("/api/resources")
public class ResourceDownloadController {
@GetMapping("/download/{fileName:.+}")
public ResponseEntity<Resource> downloadFile(@PathVariable String fileName) {
try {
// 創(chuàng)建文件資源
Path filePath = Paths.get("uploads/" + fileName);
Resource resource = new UrlResource(filePath.toUri());
// 檢查資源是否存在
if (resource.exists()) {
return ResponseEntity.ok()
.header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename="" + resource.getFilename() + """)
.contentType(MediaType.APPLICATION_OCTET_STREAM)
.body(resource);
} else {
return ResponseEntity.notFound().build();
}
} catch (Exception e) {
return ResponseEntity.internalServerError().build();
}
}
}優(yōu)勢與適用場景
優(yōu)勢
- 提供統(tǒng)一的資源抽象，易于切換資源來源
- 與Spring生態(tài)系統(tǒng)無縫集成
- 支持多種協(xié)議和位置的資源
適用場景
- 需要從多種來源提供下載的場景
- RESTful API文件下載
- 動態(tài)生成的資源下載
4. 基于ResponseEntity的下載響應
SpringBoot中，ResponseEntity類型可以精確控制HTTP響應，為文件下載提供完善的HTTP頭信息。
使用示例
@RestController
@RequestMapping("/api/download")
public class FileDownloadController {
@GetMapping("/file/{fileName:.+}")
public ResponseEntity<byte[]> downloadFile(@PathVariable String fileName) {
try {
Path filePath = Paths.get("uploads/" + fileName);
byte[] data = Files.readAllBytes(filePath);
HttpHeaders headers = new HttpHeaders();
headers.setContentDisposition(ContentDisposition.attachment()
.filename(fileName, StandardCharsets.UTF_8).build());
headers.setContentType(MediaType.APPLICATION_OCTET_STREAM);
headers.setContentLength(data.length);
return new ResponseEntity<>(data, headers, HttpStatus.OK);
} catch (IOException e) {
return ResponseEntity.notFound().build();
}
}
@GetMapping("/dynamic-pdf")
public ResponseEntity<byte[]> generatePdf() {
// 假設這里生成了PDF文件的字節(jié)數(shù)組
byte[] pdfContent = generatePdfService.createPdf();
HttpHeaders headers = new HttpHeaders();
headers.setContentDisposition(ContentDisposition.attachment()
.filename("generated-report.pdf").build());
headers.setContentType(MediaType.APPLICATION_PDF);
return new ResponseEntity<>(pdfContent, headers, HttpStatus.OK);
}
}優(yōu)勢與適用場景
優(yōu)勢
- 完全控制HTTP響應和頭信息
- 適合各種資源類型的下載
- 支持動態(tài)生成的文件下載
適用場景
- 需要精確控制HTTP響應的場景
- 動態(tài)生成的文件下載
- 自定義緩存策略的文件服務
5. 基于Servlet的原生文件操作
在某些情況下，可能需要使用原生Servlet API進行更底層的文件操作。
使用示例
@WebServlet("/servlet/download")
public class FileDownloadServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
String fileName = request.getParameter("file");
if (fileName == null || fileName.isEmpty()) {
response.sendError(HttpServletResponse.SC_BAD_REQUEST);
return;
}
File file = new File("uploads/" + fileName);
if (!file.exists()) {
response.sendError(HttpServletResponse.SC_NOT_FOUND);
return;
}
// 設置響應頭
response.setContentType("application/octet-stream");
response.setHeader("Content-Disposition", "attachment; filename="" + fileName + """);
response.setContentLength((int) file.length());
// 寫入文件內(nèi)容
try (FileInputStream input = new FileInputStream(file);
ServletOutputStream output = response.getOutputStream()) {
byte[] buffer = new byte[4096];
int bytesRead;
while ((bytesRead = input.read(buffer)) != -1) {
output.write(buffer, 0, bytesRead);
}
}
}
}要在SpringBoot中啟用Servlet：
@SpringBootApplication
@ServletComponentScan // 掃描Servlet組件
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}優(yōu)勢與適用場景
優(yōu)勢
- 對文件流操作有最大的控制權(quán)
- 可以實現(xiàn)漸進式下載和流式處理
- 對內(nèi)存使用更加高效
適用場景
- 大文件處理
- 需要細粒度控制IO操作
- 與遺留Servlet系統(tǒng)集成
6. 云存儲服務SDK集成
對于生產(chǎn)環(huán)境，將文件存儲在專業(yè)的存儲服務中通常是更好的選擇，如AWS S3、阿里云OSS、七牛云等。
配置方式（以阿里云OSS為例）
添加依賴：
<dependency>
<groupId>com.aliyun.oss</groupId>
<artifactId>aliyun-sdk-oss</artifactId>
<version>3.15.1</version>
</dependency>配置客戶端：
@Configuration
public class OssConfig {
@Value("${aliyun.oss.endpoint}")
private String endpoint;
@Value("${aliyun.oss.accessKeyId}")
private String accessKeyId;
@Value("${aliyun.oss.accessKeySecret}")
private String accessKeySecret;
@Value("${aliyun.oss.bucketName}")
private String bucketName;
@Bean
public OSS ossClient() {
return new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);
}
@Bean
public String bucketName() {
return bucketName;
}
}使用示例
@RestController
@RequestMapping("/api/oss")
public class OssFileController {
@Autowired
private OSS ossClient;
@Value("${aliyun.oss.bucketName}")
private String bucketName;
@PostMapping("/upload")
public String uploadToOss(@RequestParam("file") MultipartFile file) {
if (file.isEmpty()) {
return "請選擇文件";
}
try {
String fileName = UUID.randomUUID().toString() + "-" + file.getOriginalFilename();
// 上傳文件流
ossClient.putObject(bucketName, fileName, file.getInputStream());
// 生成訪問URL
Date expiration = new Date(System.currentTimeMillis() + 3600 * 1000);
URL url = ossClient.generatePresignedUrl(bucketName, fileName, expiration);
return "文件上傳成功，訪問URL: " + url.toString();
} catch (Exception e) {
e.printStackTrace();
return "文件上傳失敗: " + e.getMessage();
}
}
@GetMapping("/download")
public ResponseEntity<byte[]> downloadFromOss(@RequestParam("key") String objectKey) {
try {
// 獲取文件
OSSObject ossObject = ossClient.getObject(bucketName, objectKey);
// 讀取文件內(nèi)容
try (InputStream is = ossObject.getObjectContent()) {
byte[] content = IOUtils.toByteArray(is);
HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_OCTET_STREAM);
headers.setContentDisposition(ContentDisposition.attachment()
.filename(objectKey).build());
return new ResponseEntity<>(content, headers, HttpStatus.OK);
}
} catch (Exception e) {
e.printStackTrace();
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).build();
}
}
}優(yōu)勢與適用場景
優(yōu)勢
- 高可用性和可擴展性
- 內(nèi)置的安全機制和訪問控制
- 減輕應用服務器的壓力
適用場景
- 生產(chǎn)環(huán)境的文件存儲
- 需要高可用性和CDN分發(fā)的場景
- 大規(guī)模用戶上傳的應用
7. 基于Apache Tika的文件類型檢測與驗證
在文件上傳場景中，確保文件類型安全是至關重要的。Apache Tika是一個內(nèi)容分析工具包，能夠準確檢測文件的真實MIME類型，不僅依賴于文件擴展名，從而提高應用的安全性。
配置方式
添加Apache Tika依賴：
<dependency>
<groupId>org.apache.tika</groupId>
<artifactId>tika-core</artifactId>
<version>2.8.0</version>
</dependency>
<dependency>
<groupId>org.apache.tika</groupId>
<artifactId>tika-parsers-standard-package</artifactId>
<version>2.8.0</version>
</dependency>使用示例
創(chuàng)建文件驗證服務：
@Service
public class FileValidationService {
private Tika tika = new Tika();
// 驗證文件類型
public boolean isValidFileType(MultipartFile file, List<String> allowedTypes) throws IOException {
String detectedType = detectFileType(file);
return allowedTypes.stream().anyMatch(type -> detectedType.startsWith(type));
}
// 檢測文件類型
public String detectFileType(MultipartFile file) throws IOException {
try (InputStream is = file.getInputStream()) {
return tika.detect(is);
}
}
// 提取文件內(nèi)容
public String extractContent(MultipartFile file) throws IOException, TikaException, SAXException {
try (InputStream is = file.getInputStream()) {
return tika.parseToString(is);
}
}
// 提取文件元數(shù)據(jù)
public Metadata extractMetadata(MultipartFile file) throws IOException, TikaException, SAXException {
Metadata metadata = new Metadata();
metadata.set(Metadata.RESOURCE_NAME_KEY, file.getOriginalFilename());
try (InputStream is = file.getInputStream()) {
Parser parser = new AutoDetectParser();
ContentHandler handler = new DefaultHandler();
ParseContext context = new ParseContext();
parser.parse(is, handler, metadata, context);
return metadata;
}
}
}安全文件上傳控制器：
@RestController
@RequestMapping("/api/secure-upload")
public class SecureFileUploadController {
@Autowired
private FileValidationService fileValidationService;
private static final List<String> ALLOWED_DOCUMENT_TYPES = Arrays.asList(
"application/pdf",
"application/msword",
"application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"application/vnd.ms-excel",
"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
"text/plain"
);
private static final List<String> ALLOWED_IMAGE_TYPES = Arrays.asList(
"image/jpeg",
"image/png",
"image/gif",
"image/tiff"
);
@PostMapping("/document")
public ResponseEntity<Map<String, Object>> uploadDocument(@RequestParam("file") MultipartFile file) {
Map<String, Object> response = new HashMap<>();
try {
// 檢測文件類型
String detectedType = fileValidationService.detectFileType(file);
response.put("detectedType", detectedType);
// 驗證文件類型
if (!fileValidationService.isValidFileType(file, ALLOWED_DOCUMENT_TYPES)) {
response.put("success", false);
response.put("message", "文件類型不允許: " + detectedType);
return ResponseEntity.badRequest().body(response);
}
// 提取文件內(nèi)容（視文件類型）
String content = fileValidationService.extractContent(file);
response.put("contentPreview", content.length() > 200 ?
content.substring(0, 200) + "..." : content);
// 提取元數(shù)據(jù)
Metadata metadata = fileValidationService.extractMetadata(file);
Map<String, String> metadataMap = new HashMap<>();
Arrays.stream(metadata.names()).forEach(name ->
metadataMap.put(name, metadata.get(name)));
response.put("metadata", metadataMap);
// 保存文件
String fileName = UUID.randomUUID().toString() + "-" + file.getOriginalFilename();
Path path = Paths.get("secure-uploads/" + fileName);
Files.createDirectories(path.getParent());
Files.write(path, file.getBytes());
response.put("success", true);
response.put("message", "文件上傳成功");
response.put("filename", fileName);
return ResponseEntity.ok(response);
} catch (Exception e) {
response.put("success", false);
response.put("message", "文件處理失敗: " + e.getMessage());
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(response);
}
}
@PostMapping("/image")
public ResponseEntity<Map<String, Object>> uploadImage(@RequestParam("file") MultipartFile file) {
Map<String, Object> response = new HashMap<>();
try {
// 檢測文件類型
String detectedType = fileValidationService.detectFileType(file);
response.put("detectedType", detectedType);
// 驗證文件類型
if (!fileValidationService.isValidFileType(file, ALLOWED_IMAGE_TYPES)) {
response.put("success", false);
response.put("message", "圖片類型不允許: " + detectedType);
return ResponseEntity.badRequest().body(response);
}
// 提取元數(shù)據(jù)（圖片信息）
Metadata metadata = fileValidationService.extractMetadata(file);
Map<String, String> metadataMap = new HashMap<>();
Arrays.stream(metadata.names()).forEach(name ->
metadataMap.put(name, metadata.get(name)));
response.put("metadata", metadataMap);
// 獲取圖片尺寸
if (metadata.get(Metadata.IMAGE_WIDTH) != null &&
metadata.get(Metadata.IMAGE_LENGTH) != null) {
response.put("width", metadata.get(Metadata.IMAGE_WIDTH));
response.put("height", metadata.get(Metadata.IMAGE_LENGTH));
}
// 保存文件
String fileName = UUID.randomUUID().toString() + "-" + file.getOriginalFilename();
Path path = Paths.get("secure-uploads/images/" + fileName);
Files.createDirectories(path.getParent());
Files.write(path, file.getBytes());
response.put("success", true);
response.put("message", "圖片上傳成功");
response.put("filename", fileName);
return ResponseEntity.ok(response);
} catch (Exception e) {
response.put("success", false);
response.put("message", "圖片處理失敗: " + e.getMessage());
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(response);
}
}
}優(yōu)勢與適用場景
優(yōu)勢
- 提供準確的文件類型檢測，不僅依賴擴展名
- 防止惡意文件上傳，增強應用安全性
- 能夠提取文件內(nèi)容和元數(shù)據(jù)
- 支持多種文件格式的識別和內(nèi)容分析
適用場景
- 需要高安全性要求的文件上傳系統(tǒng)
- 內(nèi)容管理系統(tǒng)和文檔管理系統(tǒng)
- 需要防止惡意文件上傳的場景
需要基于文件內(nèi)容自動分類或處理的應用
總結(jié)
無論選擇哪種方案，都應根據(jù)應用的具體需求、預期用戶數(shù)量和文件大小來設計文件處理系統(tǒng)。
在大多數(shù)生產(chǎn)環(huán)境中，建議采用專門的文件存儲服務作為主要存儲方案，結(jié)合其他工具提供更好的用戶體驗。
以上就是SpringBoot實現(xiàn)文件上傳下載的7種方法的詳細內(nèi)容，更多關于SpringBoot文件上傳下載的資料請關注腳本之家其它相關文章！
相關文章
Java使用fill()數(shù)組填充的實現(xiàn)
這篇文章主要介紹了Java使用fill()數(shù)組填充的實現(xiàn)，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2021-01-01
SpringBoot使用GZIP壓縮反回數(shù)據(jù)問題
這篇文章主要介紹了SpringBoot使用GZIP壓縮反回數(shù)據(jù)問題,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2025-04-04
這篇文章主要給大家介紹了關于如何使用java判斷是不是數(shù)字的相關資料,判斷一個字符串是否為數(shù)字是Java開發(fā)中很常見的業(yè)務需求,文中通過實例代碼介紹的非常詳細,需要的朋友可以參考下2023-06-06
基于SpringBoot實現(xiàn)圖片防盜鏈的兩種方式
出于安全和性能的考慮,我們希望服務器返回的圖片資源僅在指定網(wǎng)站內(nèi)展示,防止爬蟲或其它站點直接引用圖片地址進行下載或展示,進而消耗服務器資源,所以本文給大家介紹了基于SpringBoot實現(xiàn)圖片防盜鏈的兩種方式,需要的朋友可以參考下2025-02-02
這篇文章主要介紹了Springmvc @PathVariable的用法解析，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2021-10-10
這篇文章主要介紹了Java中的TreeSet集合詳解,TreeSet 是一個 有序集合,它擴展了 AbstractSet 類并實現(xiàn)了 NavigableSet 接口,作為自平衡二叉搜索樹,二叉樹的每個節(jié)點包括一個額外的位,用于識別紅色或黑色的節(jié)點的顏色,需要的朋友可以參考下2023-09-09
maven升級版本后報錯:Blocked mirror for repositories
本文主要介紹了maven升級版本后報錯:Blocked mirror for repositories,文中的解決方法非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧2023-09-09
本文主要介紹了Java中HashMap如何解決哈希沖突，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2022-05-05
這篇文章主要介紹了快速了解Hibernate中的Session，具有一定借鑒價值，需要的朋友可以參考下。2017-12-12
這篇文章主要介紹了Java線程(Thread)四種停止方式代碼實例,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下2020-03-03