在 spring boot 的 `@postmapping` 中，`multipartfile` 类型参数必须使用 `@requestparam` 注解绑定，且请求需以 `multipart/form-data` 格式提交；不可使用 `@requestbody`，否则会因类型转换失败导致 400 错误。
MultipartFile 是 Spring 对 HTTP 文件上传（RFC 7578）的封装，其底层依赖 Servlet 容器的 Part 接口解析 multipart/form-data 请求体。因此，它只能通过 @RequestParam 绑定，且该注解必须明确指定表单字段名（即 中的 name 属性值），例如 @RequestParam("file")。
✅ 正确用法示例：
@PostMapping("/images")
public ResponseEntity saveAdvertisementImage(
@RequestParam("file") MultipartFile image) {
if (image.isEmpty()) {
return ResponseEntity.badRequest().body("文件不能为空");
}
try {
// 保存文件逻辑（如写入磁盘或上传至对象存储）
String fileName = image.getOriginalFilename();
image.transferTo(Paths.get("uploads/" + fileName));
return ResponseEntity.ok("上传成功: " + fileName);
} catch (IOException e) {
return ResponseEntity.status(500).body("上传失败: " + e.getMessage());
}
} ⚠️ 注意事项：
- 禁止使用 @RequestBody：@RequestBody 用于解析 JSON/XML 等序列化数据，而 MultipartFile 需要原始二进制流和边界（boundary）解析，二者机制冲突，强制使用将触发 HttpMessageNotReadableException。
- 确保控制器方法接收 POST 请求且 Content-Type 为 multipart/form-data：前端表单需设置 enctype="multipart/form-data"，或使用 Axios/Fetch 时通过 FormData 构造请求。
-
配置文件上传限制（可选但推荐）：在 application.yml 中调整大小限制，避免默认 1MB 限制导致上传失败：
spring: servlet: multipart: max-file-size: 10MB max-request-size: 10MB
总结：牢记一个原则——文件上传即表单提交，MultipartFile 永远是请求参数（@RequestParam），而非请求体（@RequestBody）。只要匹配前端字段名、启用 multipart 支持、并处理空文件与异常，即可稳定实现文件上传功能。
