Spring MVC上传XML文件 @RequestParam如何接收文件

@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 和前端 一致）
• 不要加 @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 handleXmlUpload(
    @RequestPart("xmlFile") MultipartFile xmlFile,
    @RequestPart(required = false) String description) {
    
    if (xmlFile.isEmpty()) {
        ret
urn 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（如传 .xml），存在安全风险
• 无法做 XML 格式校验、编码检测、流式解析等关键操作
• 真正业务中几乎没价值，建议直接弃用