SpringBoot上传文件异常-Required request part 'file' is not present

最新推荐文章于 2025-09-28 08:43:23 发布
原创 最新推荐文章于 2025-09-28 08:43:23 发布 · 4k 阅读 · 1 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

博客分享了一个问题的解决办法。首先要添加 commons-io 和 commons-fileupload 的依赖，版本分别为 1.3.2 和 1.2.1。然后在控制器中直接映射文件，使用 @RequestParam(“excelFile”) MultipartFile excelFile 即可解决问题。

今天碰到这个问题，找了一遍，解决办法如下步骤：
1.添加依赖：
< dependency>
< groupId>commons-io< /groupId>
< artifactId>commons-io< /artifactId>
< version>1.3.2< /version>
< /dependency>
< dependency>
< groupId>commons-fileupload< /groupId>
< artifactId>commons-fileupload< /artifactId>
< version>1.2.1< /version>
< /dependency>
2.控制器直接映射文件：如
@RequestParam(“excelFile”) MultipartFile excelFile
解决。

注：技术交流QQ群-595892258

Springboot的文件上传接口，使用postman测试一直报Required request part 'file' is not present错误
u013231332的博客
04-19 9400
最近在写一个springboot的文件上传接口，根据从网上找到的知识点，我很快写好了一个上传接口，接口内容如下： 和别人的接口基本一致，并且我也按照网上查找的方式，采用postman方式来上传文件，如下图所示 问题来了，我每次提交测试，都会报Required request part 'file' is not present异常，从网上找到的绝大部分答案，都是要么上传文件的ke...
Vue3图片上传报错：Required part ‘file‘ is not present.
weixin_73060959的博客
09-07 2327
错误 "Required part 'file' is not present" 通常表明服务器期望在接收到的请求中找到一个名为file的部分（即文件字段），但实际上没有找到。：在发送请求时，可能没有正确地将文件添加到 FormData 对象中，或者使用了错误的字段名。：在前端代码中，可能存在逻辑错误，导致 FormData 对象没有按预期构建。：尽管 FormData 对象构建正确，但在发送请求时可能发生了错误，导致请求体没有正确发送到服务器。：后端可能有严格的验证逻辑，要求必须存在名为file。
Spring Boot 文件上传接口 Postman 测试报错“Required request part ‘file‘ is not present”的解决全过程
最新发布
letterljhx的博客
09-28 1554
Spring Boot 文件上传接口 Postman 测试报错“Required request part ‘file‘ is not present”的解决全过程
RestClient ： Required request part ‘file‘ is not present
小子宝丁的博客
06-18 5743
解析 rest client 文件上传语法和可能导致Required request part 'file' is not present 的原因，同时介绍了 RestClient 目前的发展状况，使用时可以根据需要灵活选取
上传图片报错 Spring-boot: Required request part ‘file‘ is not present
weixin_52435453的博客
06-16 723
上传文件的文件名称不一致，例如都改成“file"，要求名称一致。 再次发送请求即可
springboot文件上传 Required request part 'file' is not present
专注于后端开发，时常接触大数据 、人工智能等
01-06 1万+
springboot文件上传 如果报错如下： The field file exceeds its maximum permitted size of 1048576 bytes. 或者如下： Required request part 'file' is not present 上面的报错可能是因为spring boot 内置的MultipartResolver有点问题，可以这样解决： ...
Required request part ‘editormd-image-file‘ is not present
Jancoyan
05-01 429
Required request part ‘editormd-image-file’ is not present 我是用的SSM框架搭建的博客系统，使用editormd进行图片上传的时候遇到了问题： 后端报错Required request part 'editormd-image-file' is not present 前端报错cannot parse json... // 具体错误记不清了，反正就是不能把一个对象转换为json格式 废话不多说，直接上解决方案。 SpringMVC处理Multipa
Springboot文件上传接口，一直报Required request part ‘zipFile‘ is not present的错误
ylx1066863710的博客
10-08 1830
最近升级了Springboot的版本，在代码没有任何改动的情况下上传接口抛出了Required request part 'zipFile' is not present的异常。 接口如下： @ApiOperation(value = "上传文件") @PostMapping(value = "/checkProcess", consumes = "multipart/form-data") public PlainResult checkProcess(@ApiParam(v
feign.FeignException: status 400 Required request part ‘file‘ is not present问题解决
carrot5032的专栏
01-15 3992
使用feign远程调用上传文件接口踩坑记录： 需要增加依赖： <dependency> <groupId>io.github.openfeign.form</groupId> <artifactId>feign-form</artifactId> <version>3.3.0</version> </dependency> <dependency> <gro
Springboot 接收文件报错 Required request part ‘file‘ is not present 解决方案
qq_40862382的博客
05-10 3090
真实有效的Springboot 接收文件报错Required request part ‘file‘ is not present解决方案
SpringBoot--Required request part ‘file‘ is not present
weixin_51982095的博客
04-19 712
今天做图片上传的功能，做好之后进行测试，一直提示“"Required request part 'file' is not present"” 在网上找各种方式，有的说配置文件，有的说别用自带的文件解析类MultipartFileResolver都没有解决我的问题。 后来仔细看发送的请求 ------WebKitFormBoundaryFlaeSM38XP7nFtBi Content-Disposition: form-data; name="fileUpload"; filename="b..
Spring-boot: Required request part ‘file‘ is not present 不传值的情况错误解决方案
weixin_40140969的博客
11-19 4635
1.看看是否缺少spring文件上传配置。 spring: servlet: multipart: enabled: true 前端代码(前端文件上传的input的name要和后台的@RequestPart的value名字一致)。 let data = new FormData(document.getElementById("form--add")); da...
spring boot 上传文件出错，Required request part 'file' is not present
热门推荐
a469517790的博客
05-21 6万+
我这个错，可能就比较奇葩了。项目用的是springboot框架，但由于项目需要，很多配置都是直接使用xml配置文件完成的，并没有交给springboot自动配置，如图：，为什么说这个呢，因为接下来就是大坑。以前spring mvc 的使用，上传文件是需要在配置文件添加一个bean的，然后再pom.xml 加上文件上传跟io的相关依赖。但是这次用了springboot，这个bean不用初始化，相关依...
springboot文件上传报错：Required request part ‘file‘ is not present
Tianguoping的博客
09-27 1万+
文件上传报错：Required request part 'file' is not present 如下使用CommonsMultipartResolver： @Configuration public class FileConfig { @Resource private Environment env; /** * @Description: 临时文件存放的目录 * @param null * @return: null *
Springboot报错Required request part ‘file‘ is not present,说一点不一样的解决方法
码海拾贝
08-18 6万+
1 堆栈信息 老规矩,先贴出堆栈信息,可以看到最终的保存信息为:org.springframework.web.multipart.support.MissingServletRequestPartException: Required request part 'file' is not present org.springframework.web.multipart.support.MissingServletRequestPartException: Required request part 'f
【SpringBoot报错】MissingServletRequestPartException: Required request part ‘file‘ is not present
weiambt的博客
03-06 1514
解决方案：将Controller的方法参数名加上注解@RequestParam(“前端属性名”)原因就是前端的属性名与Controller的方法参数名不一样导致的。大概意思是：请求参数’file’接收不到数据。
【SpringBoot报错】MissingServletRequestPartException: Required request part ‘file‘ is not present...
weiambt的博客
03-16 776
MissingServletRequestPartException: Required request part ‘file‘ is not present 大概意思是：请求参数'file'接收不到数据 原因就是前端的属性名与Controller的方法参数名不一样导致的 解决方案：将Controller的方法参数名加上注解@RequestParam("前端属性名") ...
报错Required request part ‘file‘ is not present，springBoot之文件上传_postman测试_解决办法
weixin_44797327的博客
08-11 2979
解决报错问题报错原因：分析： 报错原因： 2020-08-11 11:56:48.621 [qtp4553365-17] WARN ##-# org.springframework.web.servlet.handler.AbstractHandlerExceptionResolver.resolveException(AbstractHandlerExceptionResolver.java:140) - Resolved [org.springframework.web.multipart.suppo
前端文件上传，后端SpringMVC出现Required part ‘file‘ is not present错误解决
dfhdhjh的博客
04-19 4630
可以发现该错误不是Required part 'file' is not present，而出现该错误是因为我用了全注解的原因，因此在前端代码不变的情况下，我采用全注解的形式配置SpringMVC，因为网上有说加入一个mutiResolver类的解决方法，因此我也试了，最后发现加和不加都一样，因为我没有用到模板，因此该配置中略去前端模板的配置（已经证明与模板配置无关）先说明本人的框架使用，因为网上有许多解决办法，都有不同的框架，因此该方法可能只适用我使用的框架，当然你也可以用我的方法试试。
springboot文件上传报 required request part 'customFile' is not present
03-20
### Spring Boot 文件上传 `required request part 'customFile' is not present` 错误解决方案 当在使用 Spring Boot 进行文件上传操作时，如果遇到错误提示 `required request part 'customFile' is not present`，这通常意味着前端发送的请求中缺少指定名称的文件部分。以下是可能的原因以及对应的解决方法： #### 原因分析 1. **前端未正确设置 multipart 请求** 如果前端没有按照正确的格式构建 multipart 表单数据，则可能导致后端无法解析到名为 `'customFile'` 的文件字段[^2]。 2. **参数名不匹配** 后端代码中的 `@RequestParam("customFile")` 参数名必须与前端传递的实际字段名一致。如果不一致，也会引发此问题[^3]。 3. **Content-Type 配置不当** HTTP 请求头中需要显式声明 `Content-Type: multipart/form-data`，否则服务器不会识别该请求为文件上传请求[^4]。 --- #### 解决方案 ##### 方法一：检查并修正前端代码 确保前端通过 JavaScript 或 HTML 正确设置了表单数据结构。例如，在 JavaScript 中可以这样实现： ```javascript const formData = new FormData(); formData.append('customFile', fileInput.files[0]); // 确保 key 名称为 customFile fetch('/upload-endpoint', { method: 'POST', body: formData, }); ``` 对于 HTML 表单提交的情况，需确认 `<form>` 标签具有属性 `enctype="multipart/form-data"` 和 `method="post"`： ```html <form action="/upload-endpoint" method="post" enctype="multipart/form-data"> <input type="file" name="customFile"> <!-- 确认 input 的 name 属性 --> <button type="submit">Upload</button> </form> ``` ##### 方法二：验证后端控制器定义 后端接收文件的接口应类似于以下形式： ```java @PostMapping("/upload") public ResponseEntity<String> uploadFile(@RequestParam("customFile") MultipartFile file) { if (file.isEmpty()) { return ResponseEntity.badRequest().body("File cannot be empty"); } try { byte[] bytes = file.getBytes(); // 处理文件逻辑... return ResponseEntity.ok("File uploaded successfully!"); } catch (Exception e) { return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(e.getMessage()); } } ``` 注意这里的 `@RequestParam("customFile")` 必须严格对应前端传入的数据键名。 ##### 方法三：调整全局配置支持大文件上传 有时即使上述都无误，仍会因为默认大小限制而失败。可以在 application.properties 或 application.yml 中增加如下配置来放宽限制： ```properties spring.servlet.multipart.max-file-size=10MB spring.servlet.multipart.max-request-size=10MB ``` 或者 YAML 版本： ```yaml spring: servlet: multipart: max-file-size: 10MB max-request-size: 10MB ``` --- #### 示例代码展示 下面是一个完整的前后端交互案例供参考： ###### 前端示例（JavaScript） ```javascript document.getElementById('uploadButton').addEventListener('click', () => { const fileInput = document.getElementById('file'); const formData = new FormData(); formData.append('customFile', fileInput.files[0]); fetch('/api/upload', { method: 'POST', body: formData, }).then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error('Error:', error)); }); ``` ###### 后端示例（Java/Spring Boot） ```java @RestController @RequestMapping("/api") public class FileController { @PostMapping("/upload") public ResponseEntity<String> handleFileUpload(@RequestParam("customFile") MultipartFile file) { if (file.isEmpty()) { return ResponseEntity.badRequest().build(); } try { // Save the file or process it here. System.out.println("Uploaded file details:"); System.out.println("- Name: " + file.getOriginalFilename()); System.out.println("- Size: " + file.getSize() + " bytes"); return ResponseEntity.ok("File uploaded successfully."); } catch (Exception ex) { return ResponseEntity.internalServerError() .body("An internal server error occurred while uploading the file."); } } } ``` --- #### 总结 要彻底解决问题，建议逐一排查以下几个方面： - 确认前端是否按要求构造了 multipart 数据； - 检查后端接口参数名是否完全匹配； - 调整必要的应用级配置以适应实际需求。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Retank

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值