当 Spring Boot 控制器接收 multipart/form-data 请求时，若 MultipartFile 参数为 null，根本原因是错误使用了 @RequestBody 注解——它不适用于 multipart 表单字段，必须改用 @RequestPart 或 @RequestParam 配合正确类型。
当 spring boot 控制器接收 multipart/form-data 请求时，若 `multipartfile` 参数为 null，根本原因是错误使用了 `@requestbody` 注解——它不适用于 multipart 表单字段，必须改用 `@requestpart` 或 `@requestparam` 配合正确类型。
在 Spring Boot 中，@RequestBody 用于解析 请求体整体（如 JSON、XML），其底层依赖 HttpMessageConverter，而 MultipartFile 属于 multipart 表单中的一个独立部分（part），必须通过 @RequestPart（推荐）或 @RequestParam（仅限单文件且需类型匹配）来绑定。你当前控制器中使用：
@RequestBody(required = true) MultipartFile datafile
这是语义错误且技术上不可行的——Spring 无法将 multipart body 整体反序列化为单个 MultipartFile 对象，因此始终注入为 null。
✅ 正确做法是使用 @RequestPart（语义清晰、类型安全、支持校验）：
@RestController
public class WrapperController {
@PostMapping(value = "/test", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
public String visionPlusTester(
@RequestHeader(HttpHeaders.AUTHORIZATION) String authorization,
@RequestPart("datafile") MultipartFile datafile, // ✅ 正确：按 part 名称绑定
@RequestParam(value = "port", defaultValue = "1234") String port,
@RequestParam(value = "url", defaultValue = "10.10.10.10") String url) {
try {
byte[] content = datafile.getBytes();
// 处理文件逻辑（如保存、解析、转发等）
return "{\"status\":\"success\",\"size\":" + content.length + "}";
} catch (IOException e) {
throw new RuntimeException("Failed to read file", e);
}
}
}
⚠️ 注意事项：
- 必须显式添加
consumes = MediaType.MULTIPART_FORM_DATA_VALUE，否则 Spring 可能跳过该方法匹配； -
@RequestPart("datafile")中的"datafile"必须与客户端发送的表单字段名完全一致（你代码中requestMap.add("datafile", ...)已满足）； - 确保已启用 multipart 支持（Spring Boot 2.7+ 默认启用，但建议确认
application.yml中存在）：
spring:
servlet:
multipart:
enabled: true
max-file-size: 10MB
max-request-size: 10MB
❌ 不推荐使用 @RequestParam 绑定 MultipartFile（虽在旧版中偶有成功，但属非标准用法，且易出错）；更不推荐改为 MultiValueMap<string bytearrayresource></string> ——这会丢失 MultipartFile 的元数据（原始文件名、Content-Type、大小等），且 String.valueOf(...) 输出的是对象哈希而非文件内容，原答案中的“working code”存在严重逻辑缺陷，不可用于生产环境。
? 补充验证：若仍为 null，请检查客户端是否真正发送了 Content-Type: multipart/form-data; boundary=...，并使用 Wireshark 或日志（如 logging.level.org.springframework.web.multipart=DEBUG）确认服务端是否收到 multipart parts。
总结：修复核心在于 弃用 @RequestBody，改用 @RequestPart + 显式 consumes 声明，辅以正确的 multipart 配置与字段名匹配——这是 Spring 官方推荐且稳定可靠的 multipart 文件接收方式。
