springboot 报错org.springframework.web.multipart.support.MissingServletRequestPartException: Required request part 'file' is not present

### 解决 Spring Boot 文件上传 `MissingServletRequestPartException` 'file' not present 错误 当在Spring Boot应用中处理文件上传时，如果遇到`MissingServletRequestPartException: Required request part 'file' is not present`错误，这通常意味着服务器端未能接收到预期的文件部分。此问题可能由多种因素引起。 #### 请求封装器配置不当 一种常见原因是使用的请求封装器存在问题[^1]。确保所用的HTTP客户端正确设置了Content-Type头为multipart/form-data，并且确实包含了名为`file`的部分。对于Postman这类工具而言，需确认已选择了form-data选项卡并添加了对应的键值对。 #### 控制器方法签名不匹配 控制器中的处理器方法应该能够接收MultipartFile类型的参数来表示待上载的文件对象： ```java @PostMapping("/upload") public ResponseEntity<String> handleFileUpload(@RequestParam("file") MultipartFile file){ if(file.isEmpty()){ return new ResponseEntity<>("Please select a file!", HttpStatus.BAD_REQUEST); } try { // 处理文件逻辑... return new ResponseEntity<>("Successfully uploaded", HttpStatus.OK); } catch (Exception e) { return new ResponseEntity<>(e.getMessage(), HttpStatus.INTERNAL_SERVER_ERROR); } } ``` 上述代码片段展示了如何定义一个用于接受单个文件上传的POST映射函数[^2]。注意这里的@RequestParam注解指定了名称为`file`的请求参数，它对应于前端发送过来的数据项名。 #### 配置最大允许大小和其他设置 有时，默认的最大文件尺寸限制可能会阻止较大的文件被成功提交给服务端。可以在application.properties或application.yml里调整这些属性以适应实际需求: ```properties # application.properties example spring.servlet.multipart.max-file-size=10MB spring.servlet.multipart.max-request-size=10MB ``` 或者，在YAML格式下： ```yaml # application.yml example spring: servlet: multipart: max-file-size: "10MB" max-request-size: "10MB" ``` 通过适当修改以上配置可以增加可接受的最大文件体积以及整个请求体的总长度。