前端上传文件报这个错误Required request part 'file' is not present

解决方案
当遇到 Required request part 'file' is not present 的错误时，通常意味着服务器端未能接收到预期的文件部分。这可能是由于多种因素引起的，包括但不限于客户端请求配置不当、控制器方法参数设置有误或缺少必要的Multipart配置。
1. 配置 Multipart 支持
为了支持文件上传功能，在应用程序属性文件 (application.properties) 中应添加如下配置来启用multipart解析器[^1]:
spring.servlet.multipart.enabled=true
spring.servlet.multipart.max-file-size=10MB
spring.servlet.multipart.max-request-size=10MB
登录后复制
这些设置允许应用处理最大尺寸为10MB的单个文件以及整个HTTP请求体的最大大小同样设为10MB。
2. 修改 Controller 方法签名
确保用于接收文件上传请求的方法正确声明了所需的参数。对于表单数据中的文件字段名应当与前端发送的一致，并通过 @RequestParam 注解指明名称匹配关系[^5]：
@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.EXPECTATION_FAILED);
}
}
登录后复制
注意这里假设前端提交的数据中有一个名为 "file" 的键对应着要上传的实际文件对象；如果实际使用的不是这个名字，则需要相应调整此注解内的字符串值以保持一致。
3. 客户端请求验证
确认从前端发出POST请求的方式无误，特别是Content-Type头信息应该被设定成multipart/form-data形式以便能够携带二进制流类型的附件内容。如果是利用Postman工具来进行调试的话，请按照下述方式操作[^4]：

使用 POST 请求；
设置 URL 地址指向目标API路径；
切换Body标签页至form-data模式；
添加 key-value 对作为表单项，其中key命名为“file”，value则选择本地磁盘上的待传输文档资源。

以上措施可以有效预防因前后端交互过程中产生的误解而导致此类异常的发生。