@RequestParam不能接收文件，必须用@RequestPart+MultipartFile；因@RequestParam仅支持字符串及简单类型转换，无法解析multipart/form-data中的二进制文件内容。
@RequestParam 不能直接接收文件，必须用 @RequestPart 或 MultipartFile
Spring MVC 中 @RequestParam 只能绑定简单类型（如 String、int）或可被 Converter 解析的字符串值，**无法解析 multipart/form-data 中的二进制文件内容**。如果你在表单里上传 XML 文件并试图用 @RequestParam("file") 接收，会报 Failed to convert value of type 'java.lang.String' to required type 'org.springframework.web.multipart.MultipartFile' 或空指针异常。
- XML 文件本质是二进制 payload，需通过
MultipartFile接口读取原始字节流或输入流 -
@RequestParam会尝试把文件字段当成普通表单字段（即只取 filename 字符串），丢失文件内容 - 正确方式是使用
@RequestPart("file") MultipartFile file—— 它专为 multipart body 中的文件 part 设计
Controller 方法必须用 @RequestPart + MultipartFile，且请求头 Content-Type 要匹配
前端提交必须是 multipart/form-data 编码，后端才能触发 Spring 的 MultipartResolver 解析逻辑。否则 @RequestPart 拿不到任何东西，file 为 null。
- 确保 Controller 方法参数是
@RequestPart("xmlFile") MultipartFile xmlFile（注意 name 和前端<input name="xmlFile">一致） - 不要加
@RequestBody—— 它和 multipart 冲突，会导致 400 或空文件 - 如果同时传 JSON 元数据，用另一个
@RequestPart("metadata") String metadata分开接收（Spring 5.3+ 支持多 part） - XML 文件名、大小、内容类型可通过
xmlFile.getOriginalFilename()、xmlFile.getSize()、xmlFile.getContentType()获取
@PostMapping(value = "/upload-xml", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
public ResponseEntity<String> handleXmlUpload(
@RequestPart("xmlFile") MultipartFile xmlFile,
@RequestPart(required = false) String description) {
if (xmlFile.isEmpty()) {
return ResponseEntity.badRequest().body("No file uploaded");
}
if (!"application/xml".equals(xmlFile.getContentType()) &&
!"text/xml".equals(xmlFile.getContentType())) {
return ResponseEntity.badRequest().body("Only XML files allowed");
}
try (InputStream is = xmlFile.getInputStream()) {
// 解析 XML，例如用 JAXB / SAX / DOM
DocumentBuilder builder = DocumentBuilderFactory.newInstance().newDocumentBuilder();
Document doc = builder.parse(is);
// ... 处理逻辑
} catch (Exception e) {
return ResponseEntity.status(400).body("Invalid XML: " + e.getMessage());
}
return ResponseEntity.ok("Uploaded: " + xmlFile.getOriginalFilename());
}
常见坑：MultipartFile 为空或抛 NullPointerException
多数问题出在配置或前端调用上，不是代码逻辑本身。
- 没配
MultipartResolver：Spring Boot 2.0+ 默认启用，但若手动配了ServletWebServerFactory或用了非嵌入式容器（如部署到 Tomcat），需显式注册StandardServletMultipartResolver - 前端 FormData key 名不匹配：比如 JS 里写
formData.append("file", input.files[0])，后端却写@RequestPart("xmlFile")→ 名字必须完全一致 - XML 文件过大触发默认限制：Spring Boot 默认
spring.servlet.multipart.max-file-size=1MB，上传大 XML 会静默失败，需调大（如10MB） - 用 Postman 测试时选错了 Body 类型：必须选
form-data，Key 类型选File（不是 Text），否则后端收不到文件对象
如果非要“假装”用 @RequestParam，只能取文件名字符串（不推荐）
极少数场景下你只关心上传的 XML 文件名（比如用于日志记录），而不需要读内容，那可以加 @RequestParam("xmlFile") String filename —— 但这只是浏览器提交的原始 filename 字符串，不代表文件存在或可读，也拿不到内容、大小、类型等任何元信息。
- 该方式绕过 MultipartFile 机制，无法校验是否真有文件上传
- 用户可能伪造 filename（如传
<script>alert(1)</script>.xml），存在安全风险 - 无法做 XML 格式校验、编码检测、流式解析等关键操作
- 真正业务中几乎没价值，建议直接弃用
@RequestParam 走捷径 —— 它的设计定位就不支持二进制载荷。最容易忽略的是前后端 name 键名一致性，以及 Spring Boot 配置项里那个默认 1MB 的大小限制，改完才能传真正的 XML 配置文件。 
