SpringBoot+React图片上传报错：Required request part 'image' is not present

1. 验证前端请求的正确性 #

• 打开浏览器DevTools的Network面板，找到上传请求，查看Form Data部分：
  • 确认是否存在image字段，且字段名与后端Controller参数名完全一致（大小写敏感）
  • 检查请求头的Content-Type是否为multipart/form-data; boundary=xxx，如果是application/x-www-form-urlencoded，说明表单的enctype属性丢失，后端无法解析文件Part
  • 打印前端构建的FormData内容（比如console.log([...formData.entries()])），确认文件是否被正确添加

2. 核对后端Controller参数定义 #

• 对比修改前后的Controller代码：
  • 确保image参数的注解（@RequestPart("image")或@RequestParam("image")）和参数名与前端FormData字段匹配
  • 新增的Tag相关参数（如@RequestPart("tags") List<String> tags）需设置required=false，如果强制必填但前端未传，可能导致Spring请求解析异常，间接影响image字段的识别
  • 确认接口方法上的@PostMapping是否指定了consumes = MediaType.MULTIPART_FORM_DATA_VALUE

3. 排查前端组件的隐性变更 #

即使未修改上传逻辑，新增标签输入框可能带来意外影响：

• 检查文件输入框的name属性是否仍为image，避免被误改
• 确认文件输入框能正常获取选中文件（可通过input.files[0]在控制台验证）
• 排查新增的表单校验或交互逻辑是否阻止了文件添加到FormData

4. 检查SpringBoot Multipart配置 #

查看application.yml/application.properties：

• 确认spring.servlet.multipart.enabled=true
• 检查spring.servlet.multipart.max-file-size和spring.servlet.multipart.max-request-size是否足够，避免因文件大小超限导致解析失败（Postman能传的话此概率较低，除非前端上传文件突然变大）

内容的提问来源于stack exchange，提问作者dolpy123