SpringBoot實現(xiàn)接受文件和對象

更新時間：2025年12月06日 09:36:30 作者：LitongZero

SpringBoot中接受文件和對象的場景,推薦使用`multipart/form-data`格式,后端可以通過接受實體并將文件放入對象屬性中來處理數(shù)據(jù),使用`@Validated`注解進行參數(shù)校驗是可行的,但要注意不要與`@RequestBody`注解同時使用

SpringBoot接受文件和對象

使用場景

某個接口，需要同時接受文件和實體，也就是參數(shù)。

這個時候，前端就不能json格式傳送數(shù)據(jù)了，要用到multipart/form-data;這種格式傳送數(shù)據(jù)。
那么，這個時候，后端應(yīng)該怎樣接受這個參數(shù)和文件呢？

1.接受HttpServletRequest，自己處理request（不推薦）

@PostMapping(value = "/upload")    
@ResponseBody    
public String handleFileUpload(HttpServletRequest request) {    
MultipartHttpServletRequest params=((MultipartHttpServletRequest) request);  
// 獲取文件
List<MultipartFile> files = ((MultipartHttpServletRequest) request).getFiles("file");   
// 獲取參數(shù)
String name=params.getParameter("name");

2.接受實體，將文件放到對象屬性中（推薦）

public class UserFileReq {
	// 參數(shù)
    private String username;
    // 文件
    private MultipartFile file;
    // 省略get\set
}

@PostMapping(value = "/upload")    
@ResponseBody    
public String handleFileUpload(UserFileReq req) {    
// 文件和參數(shù) 都在實體中了
}

3.接受參數(shù)，將文件放到接受參數(shù)中

這種方法適合接受單個文件參數(shù)，多參數(shù)還是建議用對象接受，方便擴展

@PostMapping(value = "/upload")    
@ResponseBody    
public String handleFileUpload(MultipartFile file) {    
}

4.一個坑

使用第二種方法的時候，一定不要加@RequestBody，加了這個注解，就會報如下錯誤。

{
 "timestamp": 1571196217195,
 "status": 415,
 "error": "Unsupported Media Type",
 "exception": "org.springframework.web.HttpMediaTypeNotSupportedException",
 "message": "Content type 'multipart/form-data;boundary=2gOOYeFBpE;charset=UTF-8' not supported",
 "path": "/file/upload"
}

所以，接受文件，不要使用@RequestBody注解

但是@Validated注解（校驗參數(shù)的注解）是可以使用的。

總結(jié)

以上為個人經(jīng)驗，希望能給大家一個參考，也希望大家多多支持腳本之家。

您可能感興趣的文章:

相關(guān)文章

SpringBoot添加富文本編輯器操作步驟
富文本編輯器是一種能夠編輯和展示富文本內(nèi)容的工具或程序,與純文本編輯器不同,富文本編輯器可以處理文本的格式、樣式、布局等方面,使文本更加豐富多樣,本文給大家介紹了SpringBoot添加富文本編輯器操作步驟,需要的朋友可以參考下
2024-01-01
詳解如何將JAR包發(fā)布到Maven中央倉庫
這篇文章主要介紹了詳解如何將JAR包發(fā)布到Maven中央倉庫，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧
2019-01-01
java簡單工廠模式入門
下面小編就為大家?guī)硪黄猨ava工廠模式入門文章。小編覺得挺不錯的，現(xiàn)在就分享給大家，也給大家做個參考。一起跟隨小編過來看看吧
2021-07-07
Java實現(xiàn)企業(yè)員工管理系統(tǒng)
這篇文章主要為大家詳細介紹了Java實現(xiàn)企業(yè)員工管理系統(tǒng)，文中示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下
2022-02-02
詳解Java中native關(guān)鍵字
這篇文章主要為大家詳細介紹了Java中native關(guān)鍵字，什么是Native Method
2016-02-02
JavaSwing實現(xiàn)小型學(xué)生管理系統(tǒng)
這篇文章主要為大家詳細介紹了JavaSwing實現(xiàn)小型學(xué)生管理系統(tǒng)，文中示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下
2022-02-02
java實現(xiàn)遺傳算法實例分享(打印城市信息)
本文介紹java實現(xiàn)遺傳算法的實例，代碼中使用城市名做為數(shù)據(jù)，可以打印當(dāng)前代數(shù)的所有城市序列，以及其相關(guān)的參數(shù)，大家參考使用吧
2014-01-01
springcloud-feign調(diào)用報錯問題
這篇文章主要介紹了springcloud-feign調(diào)用報錯問題,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教
2024-08-08
java異常和錯誤類總結(jié)(必看篇)
下面小編就為大家?guī)硪黄猨ava異常和錯誤類總結(jié)(必看篇)。小編覺得挺不錯的，現(xiàn)在就分享給大家，也給大家做個參考。一起跟隨小編過來看看吧
2016-09-09
基于Java開發(fā)一個Markdown到Word文檔轉(zhuǎn)換工具
本文介紹了一個用Java開發(fā)的Markdown到Word文檔轉(zhuǎn)換工具,該工具通過MarkdownToWordConverter類實現(xiàn),利用flexmark庫將Markdown內(nèi)容轉(zhuǎn)換為HTML,借助jsoup庫規(guī)范化HTML,再通過docx4j庫將處理后的HTML導(dǎo)入并保存為Word文檔,需要的朋友可以參考下
2025-07-07