Spring中multipart/form-data提交出现405 Method Not Allowed错误排查

1. 路径匹配问题 #

前端请求URL是user/submitForm，请确认你的Spring控制器类上是否添加了@RequestMapping("/user")注解。如果类上没有这个注解，控制器的实际请求路径会是/submitForm，和前端请求的路径不匹配，导致找不到对应的POST接口，进而返回405错误。

修正示例：

@RestController
@RequestMapping("/user")
public class UserController {
    // 你的submitForm方法写在这里
}

2. 请求Consumes配置冲突 #

控制器方法的consumes属性同时指定了APPLICATION_JSON_VALUE和MULTIPART_FORM_DATA_VALUE，但前端发送的是multipart/form-data类型的请求，这种混合配置会导致Spring无法正确识别请求类型，触发405错误。

修正方式：只保留MULTIPART_FORM_DATA_VALUE，或者直接去掉consumes属性让Spring自动适配：

@PostMapping(value= "/submitForm", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
// 或者简化为：@PostMapping("/submitForm")
public ResponseEntity<?> userRegistration( @RequestPart("user") String user,
            @RequestPart("files") List<MultipartFile> files, BindingResult bindingResult) {
    // 原有业务逻辑
}

3. 额外优化建议 #

你可以省去手动用ObjectMapper转换JSON的步骤，直接将@RequestPart("user") String user替换为@RequestPart("user") User user，Spring会自动完成JSON字符串到User对象的转换：

public ResponseEntity<?> userRegistration( @RequestPart("user") User user,
            @RequestPart("files") List<MultipartFile> files, BindingResult bindingResult) {
    System.out.println("User : \n"+ user.toString());
    System.out.println("Files : \n"+ files.toString());
    return ResponseEntity.ok().build(); // 建议返回合法的响应，不要返回null
}

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